aboutsummaryrefslogtreecommitdiff
path: root/blog/content/notes
diff options
context:
space:
mode:
Diffstat (limited to 'blog/content/notes')
-rw-r--r--blog/content/notes/index.gmi52
-rw-r--r--blog/content/notes/interesting-articles.gmi1
-rw-r--r--blog/content/notes/tech/how-this-site-works.gmi8
-rw-r--r--blog/content/notes/tech/on-software-development.gmi3
4 files changed, 42 insertions, 22 deletions
diff --git a/blog/content/notes/index.gmi b/blog/content/notes/index.gmi
index 95933044..5453c5ee 100644
--- a/blog/content/notes/index.gmi
+++ b/blog/content/notes/index.gmi
@@ -9,9 +9,10 @@
Notes about some books and long articles I like:
=> cliffs/mythical-man-month The Mythical Man-Month
-=> cliffs/governable-spaces Governable Spaces
=> cliffs/peopleware Peopleware
+
=> cliffs/the-tyranny-of-structurelessness The tyranny of structurelessness
+=> cliffs/governable-spaces Governable Spaces
## Tech
@@ -20,36 +21,45 @@ Notes about some books and long articles I like:
=> tech/misc-linux-stuff Misc Linux stuff
=> tech/running-commands-in-linux Running commands in Linux
=> tech/ssh-for-beginners SSH for beginners
-=> tech/document-formats Document formats
+=> tech/containers-might-not-be-the-right-answer Containers might not be the right answer
+=> tech/a-monitoring-system A monitoring system
+
+=> tech/git-advice Git advice
+=> tech/github-annoyances GitHub annoyances
+=> tech/what-i-would-like-to-see-in-a-forge What I would like to see in a forge
+
=> tech/internet-communication-channels Internet communication channels
=> tech/modern-irc Modern IRC
-=> tech/ledger Ledger
=> tech/migadu Migadu
+=> tech/internet-basics Internet basics
+
+=> tech/document-formats Document formats
+=> tech/ledger Ledger
+=> tech/resumes Resumes
+
=> tech/ripping Ripping
-=> tech/about-apis About APIs
+=> tech/splicing-mkvs Splicing MKVs
+
=> tech/modularity Modularity
-=> tech/about-relational-databases About relational databases
-=> tech/containers-might-not-be-the-right-answer Containers might not be the right answer
+=> tech/about-apis About APIs
+=> tech/about-web-development About web development
+=> tech/on-software-development On software development
+=> tech/on-testing On testing
+
+=> tech/misc-python-stuff Misc Python stuff
+=> tech/python-modules-primer Python modules primer
+=> tech/so-you-want-to-play-with-functional-programming So you want to play with functional programming
+
=> tech/crud-is-an-important-unsolved-problem CRUD is an important unsolved problem
=> tech/about-django About Django
-=> tech/git-advice Git advice
-=> tech/github-annoyances GitHub annoyances
+
+=> tech/about-relational-databases About relational databases
=> tech/prolog-vs-sql Prolog vs. SQL
+=> tech/real-time-relations Real-time relations
+=> tech/motivating-example-for-logical-replication-for-dynamic-ui Motivating example for logical replication for dynamic UI
+
=> tech/take-the-less-traveled-road Take the less traveled road
=> tech/the-tragedy-of-the-geeks The tragedy of the geeks
-=> tech/misc-python-stuff Misc Python stuff
-=> tech/python-modules-primer Python modules primer
-=> tech/so-you-want-to-play-with-functional-programming So you want to play with functional programming
-=> tech/motivating-example-for-logical-replication-for-dynamic-ui Motivating example for logical replication for dynamic UI
-=> tech/real-time-relations Real-time relations
-=> tech/about-web-development About web development
-=> tech/on-software-development On software development
-=> tech/on-testing On testing
-=> tech/internet-basics Internet basics
-=> tech/splicing-mkvs Splicing MKVs
-=> tech/what-i-would-like-to-see-in-a-forge What I would like to see in a forge
-=> tech/a-monitoring-system A monitoring system
-=> tech/resumes Resumes
### Gadgets
diff --git a/blog/content/notes/interesting-articles.gmi b/blog/content/notes/interesting-articles.gmi
index b776bae9..aab7f1a0 100644
--- a/blog/content/notes/interesting-articles.gmi
+++ b/blog/content/notes/interesting-articles.gmi
@@ -141,6 +141,7 @@ All physics theories are strictly "false", but they are very true.
=> https://www.benkuhn.net/progessays/ Essays on programming I think about a lot
=> https://www.piglei.com/articles/en-programmer-reading-list-part-one/ A Programmer's Reading List: 100 Articles I Enjoyed (1-50)
=> https://matklad.github.io/links.html matklad's
+=> https://vtrlx.ca/links.html Victoria Lacroix's
## Infrequent but useful terms
diff --git a/blog/content/notes/tech/how-this-site-works.gmi b/blog/content/notes/tech/how-this-site-works.gmi
index 33218deb..eafbe7bf 100644
--- a/blog/content/notes/tech/how-this-site-works.gmi
+++ b/blog/content/notes/tech/how-this-site-works.gmi
@@ -2,7 +2,7 @@
## The use of gemtext
-This site is composed of many gemtext files following the structure of the site.
+=> https://github.com/alexpdp7/alexpdp7/tree/master/blog/content This site is composed of many gemtext files following the structure of the site.
Gemtext is the native response format of the Gemini protocol. Gemtext is much simpler and constrained than Markdown. Gemtext has only:
@@ -43,6 +43,10 @@ Interestingly, when the request does not have an Accept header that selects a un
gemini-to-http serves all Gemini requests by making an equivalent HTTP request to a web server running on the same host with a text/gemini Accept header. Therefore, when requesting gemini://alex.corcoles.net/foo this queries Apache for https://alex.corcoles.net/foo, which returns foo.gmi that is proxied back to the Gemini client.
+(The site is actually published at two different URLs, so all internal links are relative. Also extra care is required to never include extensions in links. But the differences between the gemtext and HTML conversion is minimal.)
+
+(Also, multiviews helps with pretty URLs. Because canonical URLs do not include the file format extension, they look prettier. Many websites use URLs that end in a trailing slash instead, but that tends to be annoying to do with static site generators.)
+
## Publishing the site
The site is part of a Git repository. The server hosting this site has this Git repository.
@@ -53,6 +57,8 @@ The site is part of a Git repository. The server hosting this site has this Git
I think this is a pretty optimal system to host a dual HTTP/HTML + Gemini/gemtext site. The coppewebite suite is less than 700 lines of Python code that only depends on two HTML libraries and an RSS library. The site-specific code is two shell scripts totaling less than 100 lines.
+Beyond the content, the Gemini server has barely any configuration; most of the small configuration is in Apache httpd. The overhead to support the dual site is minimal.
+
(And if instead of using the indexer to generate the list of blog entries on the front page, you maintain a list by hand, you can eliminate a significant amount of code. The Git hook for publishing is another significant amount of complex code that you can avoid.)
I believe the tools I use enable anyone to publish a site by using only a plain text editor and requiring much less knowledge about web technologies than using regular HTML (especially for the feeds).
diff --git a/blog/content/notes/tech/on-software-development.gmi b/blog/content/notes/tech/on-software-development.gmi
index 5c549f9e..cd5791ee 100644
--- a/blog/content/notes/tech/on-software-development.gmi
+++ b/blog/content/notes/tech/on-software-development.gmi
@@ -64,3 +64,6 @@ In my experience, the number of value-delivering stories done per sprint is a go
=> https://linear.app/method The Linear method.
Linear is a software development management tool that I like. Linear is designed for a process similar to Scrum, but with significant differences. The Linear method is an interesting read that describes this process.
+
+=> https://zwischenzugs.com/2022/05/29/business-value-management-autonomy-and-engineer-retention/ Business Value, Soccer Canteens, Engineer Retention, and the Bricklayer Fallacy
+About how to fit longer, less immediate tasks in incremental customer-oriented methodologies.