refactor: update articles tags to fit diataxis framework

g0di · g0di · commit 5b3c8fe6a9bd · 2025-01-31T10:40:02.000+01:00
diff --git a/content/articles/2024-01-22-dont-use-python-property.md b/content/articles/2024-01-22-dont-use-python-property.md
@@ -1,5 +1,5 @@
 Title: Don't use Python's property (for bad reasons)
-Tags: python, good-practices
+Tags: programming, python, explanation
 Description: Lean when and how to properly use Python property descriptor in your class objects
 
 I recently stumbled upon a code from one of my coworker who is rather new to Python. He is coming from a Java/Scala background and used python's `property` decorator to mimic Java Getters/Setters. Let's see why you should not do this.
diff --git a/content/articles/2024-07-11-debugger-doesnt-stop-at-breakpoints-with-pytest-if-pytest-cov-is-used.md b/content/articles/2024-07-11-debugger-doesnt-stop-at-breakpoints-with-pytest-if-pytest-cov-is-used.md
@@ -1,5 +1,5 @@
 Title: Debugger doesn't stop at breakpoints with pytest if pytest-cov is used
-Tags: python, troubleshooting, pytest, pytest-cov
+Tags: programming, python, how-to guide, pytest, pytest-cov
 Description: Troubleshoot Python debugger not working as expected and stopping at breakpoints when using pytest and pytest-cov when debugging tests.
 
 Recently, while trying to debug some of my `pytest` tests using VSCode, I discovered that my breakpoints were completely ignored and the tests never stopped. After nearly breaking my keyboard in frustration, I stumbled upon [this GitHub issue](https://github.com/microsoft/vscode-python/issues/693).
diff --git a/content/articles/2024-07-25-testing-azure-eventhub-in-python.md b/content/articles/2024-07-25-testing-azure-eventhub-in-python.md
@@ -1,5 +1,5 @@
 Title: Testing Python code integration with an Azure Eventhub
-Tags: python, azure, pytest, testing, asyncio, docker
+Tags: programming, python, how-to guide, azure, pytest, testing, asyncio, docker
 Description: Discover a way to create automated tests for your Python code integration with an Azure Eventhub using pytest, asyncio, Docker and testcontainers.
 
 On one of my project I needed to create a simple API allowing clients to publish some messages into an Azure EventHub. Because authentication is ensured by a JWT we could not rely on our clients to directly publish messages to the Eventhub (and by the way I prefer abstracting this away through a HTTP API).
diff --git a/content/articles/2024-08-02-Integrating-problem-details-rfc-with-fastapi.md b/content/articles/2024-08-02-Integrating-problem-details-rfc-with-fastapi.md
@@ -1,5 +1,5 @@
 Title: Integrating Problem Details RFC with FastAPI
-Tags: python, library, api
+Tags: programming, python, how-to guide, explanation, api
 Description: Discover a Python library of my own allowing you to quickly bootstrap a FastAPI application to returns Problem Details RFC 9457 JSON objects on HTTP errors
 
 During my past development projects, I built a lot of HTTP APIs using various langages (TypeScript, JavaScript, Python) and frameworks (fastify, FastAPI, flask, express). One thing I've noticed is that each of those frameworks have their own way of shaping HTTP error responses. This is actually not a big deal considering that most clients (i.e: HTTP clients) do not really rely on strict structure for such errors.
diff --git a/content/articles/2025-01-20-renaming-files-using-python-script.md b/content/articles/2025-01-20-renaming-files-using-python-script.md
@@ -1,5 +1,5 @@
 Title: Renaming files using Python script
-Tags: python, script
+Tags: programming, python, how-to guide, script
 Description: Discover my new Python project providing a small script for easily renaming one or several files or directories using regular expressions
 Image: https://g0di.github.io/images/benoit-godard.jpg
 
diff --git a/content/curated/2024-05-07-software-needs-to-be-more-expensive copy.md b/content/curated/2024-05-07-software-needs-to-be-more-expensive copy.md
@@ -1,5 +1,5 @@
 Title: Software needs to be more expensive
-Tags: open-source, software, thoughts
+Tags: open-source, software, explanation
 Author: Glyph Lefkowitz
 Url: https://blog.glyph.im/2024/03/software-needs-to-be-more-expensive.html
 Save_As:
diff --git a/content/curated/2024-05-09-first-jobs-ai-will-replace.md b/content/curated/2024-05-09-first-jobs-ai-will-replace.md
@@ -1,5 +1,5 @@
 Title: The first software jobs AI will replace are...
-Tags: video, software, thoughts, A.I
+Tags: video, software, explanation, A.I
 Authors: Birgitta Böckeler, Dave Farley
 Url: https://www.youtube.com/watch?v=8SuH2PfXOn8
 Save_As:
diff --git a/content/curated/2024-06-25-one-way-to-fix-circular-imports.md b/content/curated/2024-06-25-one-way-to-fix-circular-imports.md
@@ -1,5 +1,5 @@
 Title: One way to fix Python circular imports
-Tags: python, troubleshooting
+Tags: programming,python, how-to guide, troubleshooting
 Author: Ned Batchelder
 Url: https://nedbatchelder.com/blog/202405/one_way_to_fix_python_circular_imports.html
 Save_As:
diff --git a/content/curated/2024-06-25-three-laws-of-software-complexity.md b/content/curated/2024-06-25-three-laws-of-software-complexity.md
@@ -1,5 +1,5 @@
 Title: Three Laws of Software Complexity
-Tags: software, thoughts
+Tags: software, explanation
 Author: Mahesh Balakrishnan
 Url: https://maheshba.bitbucket.io/blog/2024/05/08/2024-ThreeLaws.html
 Save_As:
diff --git a/content/curated/2024-09-27-python-packaging-is-great-now.md b/content/curated/2024-09-27-python-packaging-is-great-now.md
@@ -1,5 +1,5 @@
 Title: Python packaging is great now, uv is all you need
-Tags: python, packaging
+Tags: programming, python, explanation
 Author: Juan Luis Cano Rodríguez
 Url: https://dev.to/astrojuanlu/python-packaging-is-great-now-uv-is-all-you-need-4i2d
 Save_As:
diff --git a/content/curated/2024-09-30-10-python-programming-optimisation-techniques.md b/content/curated/2024-09-30-10-python-programming-optimisation-techniques.md
@@ -1,5 +1,5 @@
 Title: 10 Python programming optimisation techniques.
-Tags: python, tips
+Tags: programming, python, how-to guide
 Author: James Ononiwu
 Url: https://dev.to/jamesbright/10-python-programming-optimisation-techniques-5ckf
 Save_As:
diff --git a/content/curated/2024-10-01-practices-of-reliable-software-design.md b/content/curated/2024-10-01-practices-of-reliable-software-design.md
@@ -1,5 +1,5 @@
 Title: Practices of reliable software design
-Tags: software
+Tags: software, explanation
 Author: kqr
 Url: https://entropicthoughts.com/practices-of-reliable-software-design
 Save_As:
diff --git a/content/curated/2024-10-02-modern-good-practices-for-python-development.md b/content/curated/2024-10-02-modern-good-practices-for-python-development.md
@@ -1,5 +1,5 @@
 Title: Modern good practices for Python development
-Tags: python, good-practices
+Tags: programming, python, explanation
 Author: Stuart Ellis
 Url: https://www.stuartellis.name/articles/python-modern-practices/
 Save_As:
diff --git a/content/curated/2024-10-08-8-versions-of-uuid-and-when-to-use-them.md b/content/curated/2024-10-08-8-versions-of-uuid-and-when-to-use-them.md
@@ -1,5 +1,5 @@
 Title: 8 versions of UUID and when to use them
-Tags: software, tips
+Tags: software, how-to guide, reference
 Author: Nicole Tietz-Sokolsaya
 Url: https://ntietz.com/blog/til-uses-for-the-different-uuid-versions
 Save_As:
diff --git a/content/curated/2024-10-14-execute-a-function-until-a-specific-value-is-returned copy.md b/content/curated/2024-10-14-execute-a-function-until-a-specific-value-is-returned copy.md
@@ -1,5 +1,5 @@
 Title: Execute a function until a specific value is returned
-Tags: python, tips
+Tags: programming, python, how-to guide
 Author: Rodrigo Girão Serrão
 Url: https://mathspp.com/blog/til/making-an-iterator-out-of-a-function
 Save_As:
diff --git a/content/curated/2025-01-15-on-the-importance-of-naming-in-programing.md b/content/curated/2025-01-15-on-the-importance-of-naming-in-programing.md
@@ -1,5 +1,5 @@
 Title: On the importance of naming in programming
-Tags: good-practices, tips
+Tags: programming, explanation, how-to guide
 Author: Martin Sosic
 Url: https://wasp-lang.dev/blog/2023/10/12/on-importance-of-naming-in-programming?ck_subscriber_id=1002125319
 Save_As:
diff --git a/content/curated/2025-01-21-6-cool-things-you-can-do-with-the-functools-module.md b/content/curated/2025-01-21-6-cool-things-you-can-do-with-the-functools-module.md
@@ -1,5 +1,5 @@
 Title: 6 cool things you can do with the functools module
-Tags: python, tips, functools
+Tags: programming, python, functools, reference, how-to guide
 Author: Bob Belderbos
 Url: https://pybit.es/articles/6-cool-things-you-can-do-with-the-functools-module/
 Save_As:
diff --git a/content/curated/2025-01-27-processing-large-json-files-in-python-without-running-out-of-memory.md b/content/curated/2025-01-27-processing-large-json-files-in-python-without-running-out-of-memory.md
@@ -1,5 +1,5 @@
 Title: Processing large JSON files in Python without running out of memory
-Tags: python, tips
+Tags: python, how-to guide, explanation
 Author: Itamar Turner-Trauring
 Url: https://pythonspeed.com/articles/json-memory-streaming/
 Save_As:
diff --git a/content/curated/2025-01-28-toasts-are-bad-ux.md b/content/curated/2025-01-28-toasts-are-bad-ux.md
@@ -1,5 +1,5 @@
 Title: Toasts are bad UX
-Tags: ux
+Tags: software, ux, explanation
 Author: Max Schmitt
 Url: https://maxschmitt.me/posts/toasts-bad-ux
 Save_As:
diff --git a/content/curated/2025-01-29-itertools-module.md b/content/curated/2025-01-29-itertools-module.md
diff --git a/content/curated/2025-01-29-module-itertools-overview.md b/content/curated/2025-01-29-module-itertools-overview.md
@@ -0,0 +1,10 @@
+Title: Module itertools overview
+Tags: programming, python, itertools, reference
+Author: Rodrigo Girão Serrão
+Url: https://mathspp.com/blog/module-itertools-overview
+Save_As:
+
+There is lot of things you can do, out of the box, using Python standard library.
+Here is a great article from Rodrigo detailing the Python `itertools` module.
+I've personally discovered tons of ways to iterate over collections I could not have even imagined.
+Rule of thumb: before developing something, double check it does not already exist on the standard library.
diff --git a/content/curated/2025-01-29-simple-css.md b/content/curated/2025-01-29-simple-css.md
@@ -1,10 +1,9 @@
-Title: Module itertools overview
-Tags: python, itertools, reference
-Author: Rodrigo Girão Serrão
-Url: https://mathspp.com/blog/module-itertools-overview
+Title: Simple CSS
+Tags: programming, css, ux, reference
+Author: Kev Quirk
+Url: https://simplecss.org/demo
 Save_As:
 
-There is lot of things you can do, out of the box, using Python standard library.
-Here is a great article from Rodrigo detailing the Python `itertools` module.
-I've personally discovered tons of ways to iterate over collections I could not have even imagined.
-Rule of thumb: before developing something, double check it does not already exist on the standard library.
+Sometimes you want to build a web application but you're quickly discouraged because you know you'll have to write CSS so it does not look like crap.
+If you're not CSS proficient you know it can be challenging (even using some existing frameworks).
+I present you Simple CSS, a very simple css framework (mostly classless) to use on your website to make it just looks good.
diff --git a/pelicanconf.py b/pelicanconf.py
@@ -16,7 +16,7 @@
 MENUITEMS = (
     ("Articles", "/category/articles.html"),
     ("Curated", "/category/curated.html"),
-    ("Tags", "/tags.html"),
+    ("Categories", "/tags.html"),
     ("About me", "/pages/about.html"),
 )
 PATH = "content"
