+1 to revert back to Jekyll, and shame on Gitbook and me to have pushed for that change.
Also, thank you Alex! Best. On Fri, 21 May 2021 at 11:40, Duncan Grant <[email protected]> wrote: > 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/ > -- Thomas Bouron Lead Software Engineer *Cloudsoft <https://cloudsoft.io/> *| Bringing Business to the Cloud GitHub: https://github.com/tbouron Twitter: https://twitter.com/eltibouron
