4 ms·
Maybe people dont care about dependencies, i do so i decided to use Go to make a single file. Because of the dependencies it seems like HotDoc only works on a
by jacec 10y ago
Maybe people dont care about dependencies, i do so i decided to use Go to make a single file.
Because of the dependencies it seems like HotDoc only works on a server?
Docsgen has versions for Windows, Mac and Linux without the need to have a server, virtual machine or stuff like that.
This is just the start of docsgen. I have planned code comment parsing, versioning, multi language support and more stuff.
Syntax highlighting is almost finished for docsgen as well.
What i'm trying to build is a really lightweight solution that everyone can use without having to setup a lot of things.
Docsgen will have a focus on API documentation rather then library documentation which HotDoc seems to focus.
- andrewshadura 10y agoI'm not sure why are you making distinction between library documentation and API documentation, especially so considering that hotdoc's GitHub repository says: ‘HotDoc: the tastiest API documentation system’.
- andrewshadura 10y agoAlso, why are you saying hotdoc works "on a server" only? What's "a server" in your understanding? By the way, hotdoc works on any platform where Python runs. In particular, once you've got Python running, pip install hotdoc installs it for you even if you don't have packages for your distribution.
- jacec 10y agoI was simply asking if it only works on a server. I was reading the installation guide and it has command line installs for Fedora and Ubuntu so i thought it was only for servers. Will pip also install the system-wide dependencies? As for API documentation vs Library documentation it just seems like HotDoc is for Library documentation. (Even though it's the tastiest API documentation system) From their examples they are just showing Library documentation sites? Docsgen is inspired by API docs like DO and PayPal where you have text on left and example request and response on the right. Example: https://developers.digitalocean.com/documentation/v2/ https://developers.digitalocean.com/documentation/v2/ I have trouble finding examples of API documentation sites that uses HotDoc, feel free to link some and i will check them.
- andrewshadura 10y agoSure, pip installs either system-wide dependencies or, if you as it, installs them into your home. As for API, I now see what you mean, you use the term API is a different meaning than I do (remote API vs local API), hence the misunderstaning. No, I don't think hotdoc supports side-by-side documentation and examples at the moment. I think it can be extended to do so, though.