Re:Show HN: SaaS for making software documentation less anno...
by doclab on Saturday April 15, 2023 @02:53PM
(#35583461)
Great and fair feedback. I think you are right that my screenshots don't show the unique parts of my software very well. The point of the first screenshot was supposed to be that you can either work with the wysiwyg editor or just do everything from cli if you never want to leave your vim. But I guess it doesn't get the point across very well. Do you think that screenshots from the version control integration would be better? For example picture of terminal window doing git commit where the system then lets you know that the page X needs an update.
Again thank you for your feedback, you definitely gave me some thoughts for improvement
- Your splash page's hero image is indistinguishable at first glance from basic Markdown. More than that, it's the kind of thing I'd expect a tool to _automatically_ generate!
- The idea of colocating documentation with the files its documenting is really interesting, and a core pain point of most internal docs ("what do I need to update when I change this file...?") I think your screenshot here can be much improved.