News for hackers. Stuff that matters.
Re:Writing a good design document by chnsh on Monday August 04, 2025 @08:39AM (#44784994)
Logistically speaking, is there a good hosting service for design docs but have google docs-like functionality to be able to comment and share feedback? I increasingly use tools like cursor to iterate on design docs that are in markdown format and currently I move things over to google docs manually and when there is feedback, I need to go back to cursor which creates a slow and weird loop. Have people identified better structures/processes for this?
Re:Writing a good design document by codazoda on Monday August 04, 2025 @09:07AM (#44785241)
We use Notion and most people seem to like it. I find it quite quirky but it does a good job of allowing comments and feedback that can then be marked as "resolved".

I'd probably prefer a pure markdown solution but I'm not aware of one.

Re:Writing a good design document by aganders3 on Monday August 04, 2025 @09:54PM (#44793515)
https://hackmd.io might fit the bill. I use it for some open source projects I work on, but don't really touch the advanced features.