4 ms·
Two immediate nits (and I mean these from a place of love — I am a sucker for docs tools): - Your splash page's hero image is indistinguishable at first glance
by jmduke 3y ago
Two immediate nits (and I mean these from a place of love — I am a sucker for docs tools):
- 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.
- doclab 3y agoGreat 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