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
Qoto Mastodon

QOTO: Question Others to Teach Ourselves
An inclusive, Academic Freedom, instance
All cultures welcome.
Hate speech and harassment strictly forbidden.