I'm trying out GitBook for documentation, it looks nice

@Gargron Yea I thought it looked nice. The lack of open-source was a killer for me though. I cant use services that people need to pay to use on an opensource project :(

@Gargron Yea :( they do have a free tier but thats only for 2 users. Any more than that youd have to pay.

I dont mind paying for myself but if i required that of my devs on any of my OSS projects I would lose a lot of devs.

@Gargron @freemo

It looks like they have a free for open-source and non-profits pricing tier, in addition to the free-basic tier:

gitbook.com/pricing

Follow

@Gargron
Here is the documentation for one of my OSS projects (Ferma). It is generated directly from *.md (markdown) files that sit along side the code.

syncleus.com/Ferma/

You can see the repo here (it is generated from the docs folder): github.com/Syncleus/Ferma

I used software called mkdocs, fully open-source. Not as nice as gitbook really but I find it gives a pretty clean looking template.

By the way if you like it and want to adopt the look and tech your welcome to steal my stylizations. I wrote it myself but its open source so feel free to steal.

@rusty

Sign in to participate in the conversation
CleverLibre Social

CleverLibre Social is an inclusive social instance for open discussion, learning, and community.
All cultures welcome.
Hate speech and harassment strictly forbidden.