Hi Michael
On 12.04.2017 15:52, [email protected] 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:\dev\servicemix-documentation\target\.scalaScriptGen\GeneratePdfDocuments_1.scala:23: > error: not found: value project > val TARGET = new File(project("project.build.directory")) > > On Tue 11/04/17 10:27 , Sobkowiak Krzysztof <[email protected]> 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/)
