Hello folks, Short update on the camel-examples. So now we have the repo for the camel-examples setup and compiled, also a basic github workflow is being added to build the project. However, the only missing piece, is to generate the docs for the examples from the new repo instead of the current one that generate the examples from the main repo using a relative path.
Regards, Omar On Tue, Feb 11, 2020 at 10:00 AM Claus Ibsen <[email protected]> wrote: > On Tue, Feb 11, 2020 at 9:49 AM Zoran Regvart <[email protected]> wrote: > > > > Hi Cameleers, > > I'll have a look at the docs + website today and see how far do I go. > > > > On Mon, Feb 10, 2020 at 2:15 PM Claus Ibsen <[email protected]> > wrote: > > > a) Add docs to camel-spring-boot with the docs website, ala spring > > > quarkus. Zoran can you help with this? > > > > Yup, it's on my todo for today as well as the camel-kafka-connector docs > > > > > b) Add Camel Spring Boot as a menu item to the Projects menu item on > the website > > > > Yup > > > > > c) Add a few docs page for Camel Spring Boot ala Camel Quarkus > > > > I can create placeholders for the docs, or are there any existing docs > > that I can reuse here? > > > > Not really, the docs are primary in the camel-spring-boot component > > https://github.com/apache/camel-spring-boot/blob/master/core/camel-spring-boot/src/main/docs/spring-boot.adoc > > But lets start with a fresh and have a bit like camel-quarkus, where > we have a clean front page. > And then a link to "extensions" which are starters in spring lingo. > And then we can have a link to the page above for the "main spring boot' > docs. > Then over time we can iterate and improve this doc. Hopefully > community users step up and help too. > > > > d) List all the Camel Spring Boot Starters in a page, and have 2 > > > links: one for auto configuration and another to point to the > > > component docs on the main website. > > > > I guess this can be based on the README.adoc[1]? > > > > Yeah the tool works like in camel-quarkus. So if we have a page > docs/modules/ROOT/pages/list-of-camel-spring-boot-components.adoc > > Then the tool will update that page too. So what we need to do is to > adjust the tool to add the links for auto configuration. > (its this maven plugin UpdateDocComponentsListMojo) > > > > e) We can look at to see if we can find out a way to inline the spring > > > boot auto configuration docs in the main docs so they are listed there > > > again (but then non SB users have docs that are convoluted with SB). > > > If we dont do this, then we have a nice clear separation and people > > > can see the SB docs on the "Camel Spring Boot" project docs. > > > > David pointed out that this can be done, i.e. have two git > > repositories contribute to the same Antora component, I need to look > > into that, might be a bit of work, most likely towards the end of the > > week. > > > > zoran > > > > [1] > https://github.com/apache/camel-spring-boot/blob/master/components-starter/README.adoc > > > > -- > > Zoran Regvart > > > > -- > Claus Ibsen > ----------------- > http://davsclaus.com @davsclaus > Camel in Action 2: https://www.manning.com/ibsen2 >
