@Gargron Yea I could do that. But i also dont like to get my open source investment to be "locked into" a commercial solution. What if they later decide to raise their prices or jsut decide to block the account because someone from Iran contributed or something. Its the same reason I decided to move off github to a self-hosted gitlab. At least gitlab is open-source so they cant raise prices and cause me to be too locked in. I can just switch to CE

@Gargron @freemo

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

https://www.gitbook.com/pricing

@rusty
Oh nice! I'd still be reluctant though. It reminds me of when my Aparapi project had a open-source license exception from intellij. We moved all our devs over to it. They changed their ToS though later and pulled the license and all our devs were left with broken build environments unless I payed a few thousand a year.

For that reason I am very cautious of getting locked in to commercial services. I will use them but only if i can easily export and move to their standards should the need arise. I can do that with gitlab (so i use it) but not sure that would be true of gitbook, so I dont.

I do agree though GitBook looks very sexy and they did a nice job.

@Gargron

@rusty @freemo Look how good it looks tho (WIP)

https://mastodon.gitbook.io/mastodon/administration/optional-features/full-text-search

@Gargron
I cant deny that, it does look very beautiful. Let me find one of my projects that uses a somewhat similar OSS solution so you can compare an alternative, one sec..

@rusty

@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.

http://syncleus.com/Ferma/

You can see the repo here (it is generated from the docs folder): https://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

@Gargron BTW kudos and focusing on documentation. It is where so many projects fail over time. I struggle with it myself sometimes but keep trying to be better.