What is this?

You have found my collection of notes. Some call it a digital garden, zettelkasten, knowledge vault, brain, whatever. This space contains all my ideas, learning, and information I want to keep for later. Mostly these notes are based on software engineering. The nature of these notes is that they are always a work in progress. Just like a garden, some areas may be beautifully tended to while other areas are more like a chaotic pile of scrap or a compost heap. At this particular point in time, the garden is a complete mess, but I just wanted to get something published, so this site is a heavy work in progress.

So why have you published these notes?

As an effort to learn in public and to motivate me to write about the things I learn. Although I have published these, the primary audience for the time being is myself.

How do I find my way around?

The garden contains two folders: maps and notes. Notes are where information is kept. They are atomic, usually containing only one idea. Maps loosely organise ideas around a category or theme, and serve as an index to help navigate to notes. Notes have tags, inbox, wip, done, stale which are mainly used to indicate the status of the note. inbox is for notes that are almost brand new. wip is for notes that have been fleshed out but that still require attention. done means I still may modify it later but the meat and potatoes are there. stale is for notes that sat in my inbox forever and I never got around to writing them while I was still interested in the topic. Since this site is published directly from my obsidian vault which I use to record information about all aspects of my life, including personal things, some notes are marked private and therefore not published. They may still be referenced from published notes, which will 404 if you try to follow the link to them!

How did you make this?

I write my notes as markdown in obsidian and used quartz to build the site. My own website is capable of parsing markdown to html, but lacks the ability to deal with obsidian flavoured markdown with things such as internal links with the double square bracket notation, and the cool graph used to visualise them. In the interest of time I wanted something out of the box!