logoalt Hacker News

murlaxtoday at 3:44 PM1 replyview on HN

We have debated this a lot in our organization. We are tired of seeing low effort Tech docs that puts the onus on the reader than the writer. I think that the writer should spend at least an order of magnitude of time more than the reader. If not, then the design doc can just be the LLM prompt that generated the document.

I have actually resorted back to hand crafting TDDs and focusing on 1-2 page docs. It is a great way to organize my thoughts and create a shared mind space among other engineers. My 2 cents.


Replies

luc_today at 4:28 PM

Can you summarize your thoughts into a single prompt that, with the context of the codebase, gets expanded to something that makes sense?