site updates

statespacedev · Apr 2, 2024 · 7a24fb5 · 7a24fb5
1 parent 1b78d52
commit 7a24fb5
Show file tree

Hide file tree

Showing 5 changed files with 97 additions and 28 deletions.
diff --git a/_posts/2024-04-01-april-fools.md b/_posts/2024-04-01-april-fools.md
diff --git a/_posts/2024-04-01-experiment.md b/_posts/2024-04-01-experiment.md
@@ -0,0 +1,6 @@
+time to try something a bit different. up till now, this project has mostly been about code - at first cpp, then mixed cpp and py, and recently all three side by side in parallel - py, cpp, and mixed. that could evolve and grow now to encompass something wider. part of what's bringing this about is a better understanding that there's two tools in hand now -
+
+- sphinx - this is about python. with python, it's standard to do docstrings within the py code files. sphinx is simply a way to convert those into a static html website.
+- jekyll - this is effectively about github. with github, it's standard to do markdown files within the project. jekyll is simply a way to convert those into a static html website.
+
+project starid has been doing sphinx 'docsascode/readthedocs' for years. what's new is - experimenting with a jekyll 'project website' as well. so two separate websites flowing out of the project - 'docsascode/readthedocs' via sphinx, 'project website' via jekyll.