The readme at https://github.com/kunalb/termdex/tree/main/markdown_files is probably the best bit.
25 karma · joined April 7, 2022
The readme at https://github.com/kunalb/termdex/tree/main/markdown_files is probably the best bit.
Heh, definitely depends on the software itself but I generally find the contents /schema of tables used to save the data very illuminating: you can see the UX, whatever form it takes -- and then what is saved to the backend so it makes things slightly more understandable for me.
I've been writing here sporadically for more than 10 years at this point, at ~1 post a year. The more recent posts took months to write, and tend to cover things I find myself repeating frequently while working with other engineers.
- https://explog.in/notes/elephants/index.html: Tips for ramping up on large projects
- https://explog.in/notes/devtools/index.html: Building developer tools
Planning to overhaul it later this year.
That's an excellent articulation of what I think as "invisible seams" when I write code: they're soft points of extensions that don't need a separate interface/function/class _yet_. Sometimes I just mark them for myself with an extra newline within a function.
The thrust of both our articles is similar, except I think I ended up using many more words.
- Scapple (mac/windows only) https://www.literatureandlatte.com/scapple/overview I love how minimal it is, but wish there was a linux/web version. I'll probably make my own some day.
- kinopio (web/mobile) kinopio.club Works well, but has a strong, quirky personality which sometimes gets annoying for me; I prefer the minimalism of scapple.
- draw.io / diagrams.net You can configure it to hide most of the toolbars and then just use it as mind mapping software, this is what I'm trying at the moment.
The slipbox code is just a bunch of python to pre-process the org files and "fix" links, which then passes them on to emacs subprocesses to generate html.
Generated with emacs running in a Github action (https://explog.in/config.html); comes with a slipbox (https://explog.in/slipbox/index.html) that I fill in using LogSeq and export to a flat website using emacs again.