Hi, I can post it to the front page right after posting updates about our upcoming releases. Should be done by tomorrow.
Thanks, Gregor On Wed, Mar 28, 2018, 8:28 AM Claus Ibsen <claus.ib...@gmail.com> wrote: > Hi > > I think we should wait to post this on the front page, until after the > 2.19.5 and 2.20.3 releases, so it will be on top of those and stay on > top for a longer while. > > On Mon, Mar 26, 2018 at 11:12 AM, Claus Ibsen <claus.ib...@gmail.com> > wrote: > > Hi > > > > I have created a new draft to post on the Camel front page. > > > > Any comments and feedback? > > > > > > > > > > Update on the Apache Camel website and documentation > > ---------------------------------------------------- > > > > The current Apache Camel website and documentation is currently > undergoing > > work to be rewamped and updated for a modern website. > > > > This work has been underway for a longer time. We kicked off the work by > > migrating the documentation of every Camel component from the wiki system > > to the source code as ascii doc files. This allowed us during the build > > of the Apache Camel project to automatic keep parts of the documentation > > up-to-date with the source code, such as when new options is added to > > components. > > We then moved on migrate all the data formats, languages, and the EIP > patterns. > > > > This has been substantional work, as if you were to print all the > > Camel documentation > > then it would be more than 3000 sheets of papers. > > > > At this point of time, we are about to draft up a new table of content > > (TOC) for the > > new Apache Camel documentation and user guide. With the new TOC we > > will then re-work > > all the user guide documentation to be updated and focus on modern > > developer with Camel. > > In doing so we will grab the good parts of the existing (older) > > documentation, and in > > places needed, we will rewrite the documentation. > > > > The new website and documentation has a new build system that is also > > worked. When this > > system is ready we will have a new staging URL where we will regularly > > publish the content, > > so users can follow the progress. > > > > Because the new documentation will be in the source code and in ascii > > doc format, then its > > easier for Camel users to contrbute and help - you can simply just > > submit patches as GitHub PRs. > > > > Have patience with us, as it may take a couple of months for us to be > > ready to publish the staging URL. > > > > We anticipate to have a new website and documentation ready after the > > summer break of 2018. > > > > On Tue, Mar 6, 2018 at 10:48 AM, Claus Ibsen <claus.ib...@gmail.com> > wrote: > >> Hi > >> > >> I think we should post a news on the Camel front page about the > >> situation with the current old website and docs vs the new website and > >> docs from the source. > >> > >> A rough plan for the new website and docs could be > >> > >> - finish migrating the EIP docs > >> - create new TOC for new documentation > >> - copy over the good parts of the old docs for the new TOC and > >> otherwise write new parts from scratch (will be ongoing through 2018) > >> - build a new modern front page > >> - use the new Camel logo > >> - publish this to a new staging url so anyone can follow the work > >> > >> A work plan could be that after the 2.21 release we will finish the > >> EIP migrations and get started on the TOC and gradually build up the > >> new documentation. At the same time folks work on the new website with > >> a new build system for publishing that, and get the tech stuff in > >> order. > >> > >> The new front page is likely where many people may have feedback/ideas > >> and it can take some time to get right - if there are more proposals > >> we could run a vote etc. Also we need new content for: > >> - What is Apache Camel > >> - How to get started etc > >> > >> eg content for onboarding new users and getting them to quickly > >> understand what Camel is. That information is needed on both the front > >> page and some beginner pages. > >> > >> As we are all busy with other duties at work / life / etc. then I dont > >> think we can do this quickly. And therefore I anticipate that we can > >> do > >> > >> - a new stating url with a prototype of the new website and docs ready > >> for summer 2018 > >> - continued work on the TOC and docs until its ready to replace the old > site > >> - switch over to new website after summer 2018 when its ready (maybe > >> as part of Camel 2.23 release etc). > >> > >> For the news on the Camel front page, then I do think we should draft > >> up a text that we can present. The stuff I wrote above is a bit > >> "rough" so I think we need to come up with a new text for the Camel > >> front page. > >> > >> Anyone wanna help with that? > >> > >> > >> > >> > >> > >> -- > >> Claus Ibsen > >> ----------------- > >> http://davsclaus.com @davsclaus > >> Camel in Action 2: https://www.manning.com/ibsen2 > > > > > > > > -- > > Claus Ibsen > > ----------------- > > http://davsclaus.com @davsclaus > > Camel in Action 2: https://www.manning.com/ibsen2 > > > > -- > Claus Ibsen > ----------------- > http://davsclaus.com @davsclaus > Camel in Action 2: https://www.manning.com/ibsen2 >
