frontpage.
newsnewestaskshowjobs

Open Source @Github

fp.

Open in hackernews

Ask HN: How do you keep notes organized across long-running side projects?

5•hackerstest•3h ago
I keep starting side projects that go on for months, and my notes end up scattered between a text file, a couple of markdown docs, and whatever I remembered to write down.

Curious how others handle this — do you keep everything in one place, or does it not matter as long as you write it down somewhere?

Comments

elenaviter•1h ago
I also work on many projects at a time. To keep up, my notes grew into a whole network of documentation. It works as a network because a coding agent can follow the links. All the notes entries are markdown and all is in git. Here's my long-run notes network:

0) Work journals. One repo for all projects at once. Each project or feature has its folder with dated entries, one entry per significant move, and a small index: a row per entry with date, link and a few lines of what happened. The project folder points to its journal and the journal points back, so when two projects touch, both sides reference each other.

1) Docs. Always maintained starting from day one of the project, not scattered in the code but usually in repo/<proj|subproj>/docs in the code repos.

2) Knowledge base with the index on top which consolidates the knowledge across projects. The index is sqlite + faiss, built from what is in git and rebuilt as it changes, and there is MCP over it. So I can ask "where did I talk about X" and get a quick recap with the links to primary notes (can be docs, journals, other knowledge base articles, sometimes source code files).

3) Issues tracker (e.g. github issues). Journal entries reference the issues (no retelling, but the linkage is preserved). Optional and for smaller projects can be solved with journals.

4) Procedures. Notes that teach how to maintain all of this while working. This is the "onboarding procedure" for a maintainer, and it is a "must read". All these piles of knowledge and sources stay sane and survive months only because the maintainers always keep the network updated as they work. My coding agents follow these same procedures and journal.

Getting back to a project after a long break or onboarding a new agent starts from reading its journal index. I describe the feature, the agent finds relevant journals and onboards itself. This just works

Chnmy•1h ago
Writing is probably the most important and easiest skill right now.

Ask HN: OpenCode no longer including DeepSeek?

4•dv35z•37m ago•0 comments

Ask HN: Is GitHub Down Again?

11•delduca•1h ago•7 comments

Ask HN: GitHub employees what's going on? Why?

321•sharts•3d ago•260 comments

Ask HN: How do you keep notes organized across long-running side projects?

5•hackerstest•3h ago•2 comments

Ask HN: Do teams really need to use GitHub?

5•avinoth•3h ago•2 comments

Ask HN: Do you need Google ads help?

5•cosbgn•6h ago•0 comments

Ask HN: Alternatives to GitHub

643•dhruv3006•4d ago•431 comments

Ask HN: I've quit six systems for tracking my illness. What works?

52•Abh1Works•5d ago•89 comments

Tell HN: Cloudflare silently injects its analytics when you switch nameservers

655•stagas•4d ago•202 comments

Ask HN: What do you think of the Intel stock now?

4•roschdal•1h ago•3 comments

Ask HN: How did you write code on restricted hardware?

3•diselody•17h ago•6 comments

Idea to reduce AI token use at large orgs

5•mgav•1d ago•0 comments

Qwen3.8 Fetches Weird URLs

7•Luker88•19h ago•0 comments

InstantDB Is Shutting Down

9•redindian75•20h ago•1 comments

Ask HN: How do you review and validate LLM generated code?

7•darkLord19•20h ago•3 comments

Are you good at AI, or just using it?

11•ppezaris•21h ago•9 comments

Ask HN: One SSH key or many SSH keys?

4•htunnicliff•21h ago•6 comments

Google Cloud us-west1 down

14•anurag•22h ago•5 comments

Ask HN: No Path from Techie to Management?

7•seeking_gruntle•23h ago•13 comments

Ask HN: Is AI the New Spreadsheet?

7•Gshaheen•23h ago•6 comments

Ask HN: Do you automate your prospection or doing hand made?

3•mathieu_aithos•23h ago•1 comments

Ask HN: What's the endgame of the AI comments buried in every post?

17•elar_verole•2d ago•14 comments

Is this AWS RI/SP simulation engine interesting / valuable?

2•Exstratus•1d ago•1 comments

Algorithm Interview: a conversation between two parrots

3•dersoverflow•1d ago•0 comments

You've reached the end!