All,

The apache brooklyn docs have become difficult to build as they are based
on gitbook, which has moved away from supporting an OSS model. [1]. Because
of this the giitbook cli is no longer being maintained and, on mac at
least, is becoming difficult to run. On the other hand Jekyll [2] is in
active development and is being well supported by the community.

So Alex has created a PR [3] to revert back to using Jekyll and update to
the latest ruby and Jekyll releases.  I've tested this and it is working
well and building locally is almost instantaneous making it really nice to
update the docs.

It doesn mean we've lost the template/formatting that we had with gitbook
and it looks like it did in the past but I think that having a working and
easily updatable set of docs is more important.  Obviously we would welcome
any commits from anyone who wishes to improve the styling.

I'll merge Alex's PR later today if no one has any major objections.

thanks

Duncan

[1] https://github.com/GitbookIO/gitbook
[2] https://github.com/jekyll/jekyll
[3] https://github.com/apache/brooklyn-docs/pull/315

-- 
Duncan Grant
Lead Software Engineer

*Cloudsoft <https://cloudsoft.io/> *| Bringing Business to the Cloud

GitHub: https://github.com/duncangrant/

Reply via email to