Thanks, Krzysztof! Will do, and post updates here.
Kind regards Michael On Wed 19/04/17 22:20 , Krzysztof Sobkowiak <[email protected]> wrote: > Hi Michael > Good job!!. It looks good and is a good start point for the further > rework of the documentation. > You can also simply remove all the JBI and NMR stuff as it is no more > supported since ServiceMix 5. > Kindly regards > Krzysztof > On 17.04.2017 21:31, Michael Gfeller wrote: > > Hi again, > > > > I've uploaded a first version to > http://www.mgfeller.net/servicemix/ > > Migrated to Asciidoctor as-is, more or less. > > Next, I plan to go through the quickstart guide. > > > > Feedback is welcome :-) > > > > Kind regards, > > > > Michael > > > > On 13.04.2017 13:00, wrote: > >> Hi Krzysztof, > >> > >> Excellent :-) > >> > >> I forked https://github.com/apache/servicemix-documentation and > give it a go. > >> > >> My plan is to first migrate to AsciiDoctor as-is, then go through > the text, run the examples, and update the bits I can. > >> > >> Later, the Karaf-documentation could be included, and the > ServiceMix documentation could become a module in servicemix. > >> > >> But one thing at the time :-) See how far I get. > >> > >> Does this sound OK? > >> > >> Kind regards > >> > >> Michael > >> > >> On Wed 12/04/17 22:37 , Krzysztof Sobkowiak wrote: > >> > >>> Hi Michael > >>> On 12.04.2017 15:52, wrote: > >>>> Hi, > >>>> > >>>> Ok, I see. > >>>> > >>>> I tried to build the documentation, but it failed (see below) - > >>> maybe because I have not installed the prerequisites? Built with > Java7 > >>> and maven 3.3.9. > >>> I didn't try this script yet, but it may be the problem. > >>>> I converted the documentation using ScalateToAsciidoc and ran > >>> Asciidoctor on the result, to me it looked like (quite) some > manual > >>> work is needed, for structuring the documents, formatting source > code, > >>> possibly tables (if there are any), etc. > >>>> On the other hand, there are not so many files (ca 25), so that > >>> does not look like a lot of work :-) > >>>> > >>>> Is it still planned to include the Karaf documentation? > >>> I think it makes sense to include the Karaf documentation (during > the > >>> build), but we can also do this later. > >>>> Would it be an idea to replace Pygments with Coderay when using > >>> Asciidoctor in order to avoid being dependent on python? > >>> I'm not familiar with Pygments or Coderay, but I think, it makes > >>> sense to do this in the same way like Karaf Container. > >>>> The Karaf Container documentation appears to be one standard > >>> Asciidoctor file, could that be an acceptable first version for > the > >>> ServiceMix documentation too? > >>> Yes, of course. > >>>> I have some experience with Asciidoctor, but have only just > started > >>> looking at ServiceMix... > >>> We would be glad if we could profit from your experience. Each > >>> contribution is warm welcome and good start to the journey into > open > >>> source. Many people just start looking at a product or library > >>> developed by open source community and then decide to become part > of > >>> this community :) > >>> Kindly regards > >>> Krzysztof > >>>> > >>>> Kind regards, > >>>> > >>>> Michael > >>>> > >>>> P.S. Failed with several errors like: > >>>> > >>> > C:devservicemix-documentationtarget.scalaScriptGenGeneratePdfDocuments_1.sc > >>> ala:23:error: not found: value project > >>>> val TARGET = new File(project("project.build.directory")) > >>>> > >>>> On Tue 11/04/17 10:27 , Sobkowiak Krzysztof wrote: > >>>> > >>>>> Hi > >>>>> I think it's easier to update the documentation first to the > >>> actual > >>>>> state (e.g. some commands in Karaf have been changed and the > >>> samples > >>>>> in the documentation are no more up to date. > >>>>> For the migration to asciidoc, Morgan Hautman has written a > script > >>>>> which migrates the Scalate based documentation into Asciidoc > >>>>> https://github.com/mhautman/ScalateToAsciidoc. Next there is > some > >>>>> manual job to do but this script makes the most of the job. > >>>>> Kindly regards > >>>>> Krzysztof > >>>>> On 11.04.2017 11:05, wrote: > >>>>>> Hi Krzysztof, > >>>>>> Thanks for your quick answer. > >>>>>> Looking forward to all that! Will the documentation be > migrated > >>>>> as-is > >>>>>> at first, or updated at the same time? > >>>>>> I try to follow and contribute if I have time, also depending > on > >>>>>> whether I will be able to continue working with ServiceMix > (still > >>>>>> evaluating). > >>>>>> Kind regards, > >>>>>> Michael > >>>>>> BODY { font-family:Arial, Helvetica, > sans-serif;font-size:12px; > >>> } > >>>>>> On Mon 10/04/17 12:58 , Sobkowiak Krzysztof wrote: > >>>>>> Hi Michael > >>>>>> Yes, this is this repository, but trunk has not been updated > to > >>>>>> ServiceMix 7 yet. Asciidoc is another theme which has to be > done. > >>>>> We > >>>>>> have also plans to maintain the documentation within the > >>> ServiceMix > >>>>>> assembly repository (like in Karaf) after migration to > asciidoc. > >>>>>> Kindly regards > >>>>>> Krzysztof > >>>>>> On 10.04.2017 13:15, wrote: > >>>>>> > Hi! > >>>>>> > I'm new to ServiceMix and was following the QuickStart > Guide > >>>>>> > > >>> http://servicemix.apache.org/docs/7.x/quickstart/quickstart.pdf > >>>>> [1] > >>>>>> > As another user reported, there are some minor mistakes, > >>> which > >>>>> I > >>>>>> > thought I could submit a PR for. Unfortunately, I can't > seem > >>> to > >>>>>> find > >>>>>> > the documentation source for 7.x. > >>>>>> > Is it also on GitHub? > >>>>>> > > https://github.com/apache/servicemix-documentation/tree/trunk > >>>>> looks > >>>>>> to > >>>>>> > be for the 6.x version? > >>>>>> > ksobkowiak mentioned the plan to migrate to AsciiDoc(tor?) > >>> :-) > >>>>>> maybe > >>>>>> > I could submit a PR there? > >>>>>> > Thanks in advance! > >>>>>> > Regards, > >>>>>> > Michael > >>>>>> > > >>>>>> > > >>>>>> > Links: > >>>>>> > ------ > >>>>>> > [1] > >>>>> http://servicemix.apache.org/docs/7.x/quickstart/quickstart.pdf > >>>>> > >>> -- > >>> Krzysztof Sobkowiak (@ksobkowiak) > >>> JEE & OSS Architect, Integration Architect > >>> Apache Software Foundation Member (http://apache.org/) > >>> Apache ServiceMix Committer & PMC Member > >>> (http://servicemix.apache.org/) > >>> Senior Solution Architect @ Capgemini SSC > >>> (http://www.capgeminisoftware.pl/) > >>> > >>> > >> > -- > Krzysztof Sobkowiak (@ksobkowiak) > JEE & OSS Architect, Integration Architect > Apache Software Foundation Member (http://apache.org/) > Apache ServiceMix Committer & PMC Member > (http://servicemix.apache.org/) > Senior Solution Architect @ Capgemini SSC > (http://www.capgeminisoftware.pl/) > >
