Show HN: Paperdocs, better documentation for the web
francisco.io
francisco.io
Some nitpicks:
1. It would be nice to have an easy way to link to a specific (sub)section. I see the heading IDs are already there, so maybe just add some small anchor icons like [1]? Also, it might be good to change the anchor in the addressbar when clicking a side menu item.
2. It doesn't work without JS. I know it's common with a lot of websites today, but software docs may be the thing people sometimes need to view in a console browser with 80×24 resolution when the shit hits the fan… EDIT: I see you have a way for server-side render described in your Readme, that's great. :)
3. The print stylesheet could use some tweaking. Eg. these "Author Demo Github" links take up a relatively large space and they are pretty much useless on paper. Same with the menu heading and hamburger icon. [2] The links are even overlapping the content on some pages. [3] I don't know how often people print out documentation, but it might be a pretty common use case.
[1] – https://vgy.me/MvofaK.png – from Github and ReadTheDocs
[2] – https://vgy.me/a27pqw.png
[3] – https://vgy.me/RzRqxA.png
Screenshots taken in Chrome 56 on Linux.
1. I will totally do that.
2. The recommended way in the documentation is to "render it server-side", as in use normal html+css (or use some build system of your own). The "load file through javascript" is nice but has some other problems such as SEO so it's just an alternative.
3. Also totally going to tweak it for print, right now there's nothing specific.
<script src="//localhost:35729/livereload.js">