News for hackers. Stuff that matters.
Re:Screw it, I’ll host it myself by koyote on Wednesday April 07, 2021 @06:23PM (#26732249)
I encounter this every 6-12 months when I go back to an old project that is 'working' and want to add something/update something and it all just looks foreign to me.

The worst thing is that I have often gone through a lot of effort around making it easy to set up and deploy (docker and whatnot) but even that I have forgotten about. (I came across a docker file in an old project and couldn't get it to work properly until I noticed that there was a docker compose file lying around that I had missed)

How do you keep track of documentation? I guess for a project a README in the git's root is a good start, but what about more complex systems stuff that does not live in a git project? For example, I had to manually edit a bunch of config files on my Proxmox setup to get docker and some other things to work properly. Where would I document such manual steps? I am thinking a text file somewhere in cloud storage but then of course I'd need to remember that...

Re:Screw it, I’ll host it myself by scambier on Thursday April 08, 2021 @05:21AM (#26736743)
My doc is split between Notion (for bigger, structured projects) and a bunch of local md files (for general, greppable knowledge).

For my VPS, I have a Notion page where each project (name, url, mapped ports) is a row in a table. Then the project page contains a copy of my docker config and various informations I might need for maintenance/reinstallation.

Re:Screw it, I’ll host it myself by simmonmt on Wednesday April 07, 2021 @07:36PM (#26733050)
I don’t try to put the documentation next to the thing being described because then I’ll lose track of it. I set up a simple Gollum wiki and put everything there. That way I get md for useful formatting, version control on the docs without having to create a zillion git repos, and I never have to wonder where the docs are.
Re:Screw it, I’ll host it myself by randomdude402 on Wednesday April 07, 2021 @08:38PM (#26733604)
I use a single git repo for all my personal project docs.