Connected notes in Jekyll
Each card holds a focused piece of the story. The links explain why another piece belongs beside it.
One file, one stable address
A card is a Markdown document in a Jekyll collection. Its front matter records its title, group, ordering and links. Its explicit permalink keeps the public address stable even if I change the title. This is a practical use of Jekyll collections.
For example, the SalesCandy card can connect to AWS with an explanation of why that technology belongs in the account of that role. The relationship is written once, on the source card.
Three kinds of connection
Follow a connection shows the relationships I have explicitly written, with a reason for each one.
Linked from shows the cards that point into the current card. It is generated from those same relationships, preserving their explanations. I do not have to maintain a second list by hand.
Mentioned in shows ordinary links found in another card’s introduction or body. These are useful for discovery, but an unexplained mention should not be mistaken for evidence of a project or qualification. If a card both mentions and explicitly connects to another card, only its explained backlink is shown.
Make the links dependable
The build checks for missing targets and fragments. It also excludes menus, citations and generated relationship lists from mention discovery, so navigation does not manufacture more relationships.
This follows the interest behind my shared-brain article: small notes that can be linked and recombined. Cloudflare Workers is the publishing destination for the configured workflow; the note structure belongs to the Jekyll source and survives independently of the host.