Ask HN: HN How to Get Feedback on Software Design Docs

[8ta4]

I'm working on a voice transcription tool and I wrote a software design document. It's all text, no diagrams. It covers the technical architecture and functionality.

- Where can I share it to get some constructive feedback?

- How can I avoid sounding like I'm just promoting my work?

I'm all for constructive feedback, but the internet's version of "constructive" can sometimes feel like a sledgehammer to the ego.

[joshxyz]

how about just create a github gist and post it here?

of course there will be good and bad ounding feedback, but at least you put it out there and it lets you weigh in and refine your idea.

[8ta4]

Thank you, joshxyz, you've just given me the perfect excuse to show off my work, all under the pretense of seeking feedback. Check it out!

https://github.com/8ta4/say/blob/7dad55cc3faf65e367cd9cbe18d...

But seriously, I do value your feedback.

[arunc]

Put it on a GitHub repo with a file ARCHITECTURE.md. It helps you write diagrams with Mermaid if needed.