feat: Migrate Notion public portal content to Hugo

Author: w0rp

.gitattributes

@@ -7,3 +7,4 @@
 *.aac filter=lfs diff=lfs merge=lfs -text
 *.mp3 filter=lfs diff=lfs merge=lfs -text
 *.flac filter=lfs diff=lfs merge=lfs -text
+*.svg filter=lfs diff=lfs merge=lfs -text

config.toml

@@ -97,8 +97,8 @@ pygmentsCodefencesGuessSyntax = true
 [[menu.main]]
     parent = "resources"
     identifier = "portal"
-    name = "🔗 Portal"
-    url = "https://dense-analysis.notion.site/Dense-Analysis-Education-Portal-3bf400d2c185412d8a4ff514207e82d0"
+    name = "Education Portal"
+    url = "portal/"
     weight = 2
 
 # 4. About Links

content/portal/_index.md

@@ -0,0 +1,16 @@
+---
+title: Dense Analysis Education Portal
+---
+
+Welcome to Dense Analysis Education Portal. All content within is public and
+available to the Internet at large, free for all to read.
+Please review the [⚖️ Publishing Rules](publishing-rules/) before contributing
+to the Portal.
+
+## Topic Index
+
+- ⚖️ [Publishing Rules](publishing-rules/)
+- 🎯 [The PC System](pc-system/)
+- 💬 [Dense Analysis Philosophy](dense-analysis-philosophy/)
+- 🔗 [Connecting APIs](connecting-apis/)
+- 📊 [Spreadsheet Speed](spreadsheet-speed/)

content/portal/connecting-apis.md

@@ -0,0 +1,56 @@
+---
+title: 🔗 Connecting APIs
+---
+
+This page documents Dense Analysis recommendations for connecting APIs together
+and how microservices in general ought to be bridged together.
+
+## Principles
+
+1. You should never write REST client code by hand: generate it.
+2. Swagger specs are obsolete: use
+   [OpenAPI](https://spec.openapis.org/oas/latest.html) specs.
+3. Always write async or concurrent code: write for the future.
+
+## How to Make REST Calls
+
+This section lists the best ways to make REST API request calls from code in
+different languages.
+
+- Go -- `net/http` standard library calls with
+  [goroutines](https://go.dev/tour/concurrency/1)
+- Python -- [aiohttp](https://docs.aiohttp.org/en/stable/) is the best solution
+- TypeScript -- Use
+  [fetch()](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API)
+
+## OpenAPI
+
+Use the Dense Analysis down converter for OpenAPI specs where you only have
+3.0 spec support. See:
+https://denseanalysis.org/blog/post/2025-03-27-openapi-spec-converter/
+
+- Go -- OpenAPI 3.0:
+  https://github.com/oapi-codegen/oapi-codegen
+  which uses https://github.com/getkin/kin-openapi
+- Python -- OpenAPI 3.0, 3.1:
+  https://github.com/MarcoMuellner/openapi-python-generator
+  (Use `aiohttp` mode)
+- TypeScript -- OpenAPI 2.0, 3.0, 3.1:
+  https://github.com/hey-api/openapi-ts
+  (Generate `fetch` calls)
+
+### How to Export OpenAPI Specs
+
+1. Use CI or CD rules to generate specs from code and publish them.
+2. Publish in OpenAPI 3.0 as JSON with the Dense Analysis down-converter.
+3. Publish in OpenAPI 3.1 JSON as well, which may not suffer from
+   down-conversion bugs.
+4. `git commit` and use generated spec files and generated code in other repos.
+5. Never modify generated code by hand: import and extend it.
+
+## Documentation
+
+Use [Redoc](https://github.com/Redocly/redoc) to take a generated spec and
+serve it via the web. You can run it via a Docker image. If you are building a
+FastAPI web app, [Redoc support](https://fastapi.tiangolo.com/features/#automatic-docs)
+is enabled by default and is available via the `/redoc` endpoint by default.

content/portal/dense-analysis-philosophy.md

@@ -0,0 +1,64 @@
+---
+title: 💬 Dense Analysis Philosophy
+---
+
+This page documents important Dense Analysis philosophy used to teach
+important concepts to the public. Sections are ordered alphabetically and
+represent independent concepts.
+
+## Dense Analysis
+
+An important aspect of Dense Analysis is the phrase itself. Much as one can
+"google" something to search, one can apply "dense analysis." To analyze
+something densely, apply analysis that is both "dumb" and also "deep." Apply
+the [KISS Principle](https://people.apache.org/~fhanik/kiss.html) to analysis,
+and remember to not overthink things. Treat your thoughts and process as
+time-sensitive, and
+[timebox](https://en.wikipedia.org/wiki/Timeboxing) your analysis. Recognize
+the [Dunning-Kruger effect](https://en.wikipedia.org/wiki/Dunning%E2%80%93Kruger_effect)
+as being present in your own mind, and embrace simple ideas. Be smart by being
+"dumb."
+
+## Class-oriented Programming (COP)
+
+What most in this world consider to be object-oriented programming (OOP) is on
+average nothing but a gigantic mess of classes and inheritance that never
+builds towards software that can be maintained or understood over time. A
+`struct` or `class` in any language is only designed to be a means of
+constructing types, and languages such as Java have poisoned the mind of the
+public into thinking that classes solve all problems: they do not. Problems are
+solved by implementing procedures. We call this mind poison "Class-oriented
+Programming," or "COP" for short.
+
+For more information on how to re-learn the true virtues of object-oriented
+programming, please review the following lecture by James Coplien.
+
+[https://www.youtube.com/watch?v=wbuXxB7j260](https://www.youtube.com/watch?v=wbuXxB7j260)
+
+## Esmeralda's Spoon
+
+Concept: When expectations are not perfectly aligned, and things you should not
+care about become a problem all of a sudden.
+
+A long time ago in a land near the sea, a colleague of Andrew Wray's was
+working as an engineer of burritos. His manager Esmeralda had a routine whereby
+she would ask the staff to tidy up the burrito establishment at close. After
+the staff had concluded cleaning up the establishment, Esmeralda would ask the
+staff to confirm they had finished cleaning the entire establishment from top
+to bottom. After staff confirmed they had in fact cleaned everything,
+Esmeralda would reach into some unforgettable place in the restaurant and
+produce a spoon, and she would say, "You did not clean everything! You did not
+find this spoon!"
+
+Esmeralda possessed unrealistic expectations about the cleanliness of the
+restaurant and was a poor communicator, and terrible team manager. Her antics
+only served to annoy those she managed. This tale is an example of when
+managers fail to communicate their expectations accurately to staff,
+demonstrate a lack of trust in staff, and where surprises come from out of
+nowhere that you, as a member of staff, could not have been prepared for.
+
+An "Esmeralda's Spoon" refers to any situation where some terrible and
+unknowable thing is suddenly brought about and emerges as a priority from
+seemingly out of nowhere. These incidents can be referred to as "a spoon" for
+short. Learn to do additional discovery and learn how to deal with the
+emergence of random and unexpected failures.