[Hawkular-dev] Any objections to using gitbooks?

[Gary Brown]

Hi

Once I have a reason version, I was thinking about changing the link from the Documentation->Sub-projects->Application Performance Management to link to the content link: https://hawkular.gitbooks.io/hawkular-apm-user-guide/content/

The first part of the intro could then be able it being a component of the Hawkular project, and having a link back to the website?

Regards
Gary

----- Original Message -----
> The main drawback I see is the lack of integration with hawkular.org , any
> thoughts how we can overcome that issue ?
> 
> On Tue, Jun 7, 2016 at 5:36 PM, Gary Brown < gbrown at redhat.com > wrote:
> 
> 
> Was fairly straightforward - I've just transferred BTM content with some
> changes (related to rename) - so more work is required on the content, and
> need to setup travis to install changes to REST docs, but:
> 
> 1) Content is automatically made available here:
> https://hawkular.gitbooks.io/hawkular-apm-user-guide/content/
> 
> 2) Can also obtain PDF from this page:
> https://www.gitbook.com/book/hawkular/hawkular-apm-user-guide/details
> 
> 3) Once github repo has been setup, and initial README.adoc SUMMARY.adoc and
> .gitignore have been created, can run:
> 
> npm install gitbook-cli -g
> 
> gitbook serve
> 
> and then see content on localhost:4000
> 
> Regards
> Gary
> 
> 
> ----- Original Message -----
> > So Hawkular APM will give it a try...
> > 
> > The Git repo is here:
> > https://github.com/hawkular/hawkular-apm-user-guide
> > 
> > And the published book will be here:
> > https://www.gitbook.com/book/hawkular/hawkular-apm-user-guide/welcome
> > 
> > 
> > PS: At least another project/product used it successfully it seems:
> > Keycloak
> > / Red Hat SSO
> > 
> > 
> > 
> > On Mon, Jun 6, 2016 at 10:36 AM, Thomas Heute < theute at redhat.com > wrote:
> > 
> > 
> > 
> > I mostly have concerns about having docs spread over multiple solutions.
> > But
> > if the plan is to move all to gitbook, it should be ok.
> > 
> > Also we should still use AsciiDoc (I see that gitbook supports AscissDoc
> > and
> > Markdown)
> > 
> > Thomas
> > 
> > On Mon, Jun 6, 2016 at 9:27 AM, Gary Brown < gbrown at redhat.com > wrote:
> > 
> > 
> > Hi
> > 
> > Wondering if gitbooks was ever considered for the documentation? Seems
> > ideal
> > as we can version each book with the component(s) it relates to, and users
> > can download a pdf version for use offline.
> > 
> > Was thinking about experimenting with it for the updated APM docs?
> > 
> > Any objections?
> > 
> > Regards
> > Gary
> > _______________________________________________
> > hawkular-dev mailing list
> > hawkular-dev at lists.jboss.org
> > https://lists.jboss.org/mailman/listinfo/hawkular-dev
> > 
> > 
> > 
> > 
> > 
> > _______________________________________________
> > hawkular-dev mailing list
> > hawkular-dev at lists.jboss.org
> > https://lists.jboss.org/mailman/listinfo/hawkular-dev
> > 
> _______________________________________________
> hawkular-dev mailing list
> hawkular-dev at lists.jboss.org
> https://lists.jboss.org/mailman/listinfo/hawkular-dev
> 
> 
> 
> 
> _______________________________________________
> hawkular-dev mailing list
> hawkular-dev at lists.jboss.org
> https://lists.jboss.org/mailman/listinfo/hawkular-dev
>