Grokbase › Groups › Cayenne › dev › April 2011
FAQ
(this is the first of 2 Maven threads that I am starting, following our recent conversations).

We use it to load artifacts that are not available in central. It would be great to get rid of it completely, so let's see what we can do. Artifacts loaded from it are in the following categories:

* public open source projects (IIRC some versions of Hessian. maybe others). We should identify those and submit them to central ourselves.

* jdbc-compat that is our hack to compile Java 1.5 code (we still maintain full 1.5 compatibility of Cayenne 3.0 and 3.1) with Java 1.6. I don't think it is appropriate to post it to central. Maybe move it to Cayenne build-tools, so that it sits in our own build tree? Don't think it creates any licensing issues as long as we don't deploy it anywhere.

* com.atlassian.confluence:confluence-soap:2.0. This is to extract documentation from Confluence. We can put some extra effort and build the SOAP client ourselves (should be trivial in theory). However this may not be needed. ASF Infra is moving full speed to kill Confluence-as-site-engine and we should start thinking about switching to the new ASF CMS.

Andrus

Search Discussions

  • Christian Grobmeier at Apr 18, 2011 at 9:01 am ⇧
    * com.atlassian.confluence:confluence-soap:2.0. This is to extract documentation from Confluence. We can put some extra effort and build the SOAP client ourselves (should be trivial in theory). However this may not be needed. ASF Infra is moving full speed to kill Confluence-as-site-engine and we should start thinking about switching to the new ASF CMS.
    I am +1000 on this. Contributions to the docs are lots easier since
    its based on SVN.

    Cheers
  • Andrus Adamchik at Apr 18, 2011 at 9:20 am ⇧

    On Apr 18, 2011, at 12:01 PM, Christian Grobmeier wrote:

    Contributions to the docs are lots easier since
    its based on SVN.
    Funny you brought this up. Before Confluence we used Anakia, and the reason we switched to Confluence was because Anakia was SVN based :-) Well, I guess not specifically because of SVN, but because of the unfriendly workflow in general. Not comparing the new CMS to Anakia (I haven't seen it yet, I hope the workflow is nothing like it). Interesting how things are evolving in circles.

    Andrus
  • Aristedes Maniatis at Apr 25, 2011 at 12:29 pm ⇧

    On 18/04/11 6:51 PM, Andrus Adamchik wrote:
    * com.atlassian.confluence:confluence-soap:2.0. This is to extract documentation from Confluence. We can put some extra effort and build the SOAP client ourselves (should be trivial in theory). However this may not be needed. ASF Infra is moving full speed to kill Confluence-as-site-engine and we should start thinking about switching to the new ASF CMS.
    I've spent a lot of time over the last year working with docbook and am finding it really rather nice. Its advantages over the latest ASF CMS efforts are that you write semantic documentation, rather than crafting it into html around the design. This means, amongst other things, that we can easily produce pdf/html/etc formats. I have lots of examples if people are interested in seeing it.

    I've also got the maven build scripts for producing docbook worked out in detail, so I can easily contribute all that.

    The main downside, is that all the docs need to be rewritten. And that's lots of lots of work. The best docbook editor available is Oxygen Author (not a free product). I'd be happy to set up the basic structure of the docs, the build scripts and a few pages. But I'll not have the time to rewrite all the pages. If the consensus is yes to docbook, I am happy to get the first part done.



    Ari

    --
    -------------------------->
    Aristedes Maniatis
    GPG fingerprint CBFB 84B4 738D 4E87 5E5C 5EFA EF6A 7D2E 3E49 102A
  • Christian Grobmeier at Apr 26, 2011 at 6:32 am ⇧

    we should start thinking about switching to the new ASF CMS.
    I've spent a lot of time over the last year working with docbook and am
    finding it really rather nice.
    I had a time where I compared Forrest with Docbook and finally found
    Docbook very interesting myself. It can be generated to plain html and
    one can send patches. This are my strongest requirements. Besides, its
    easily editable and quite easy to learn.
    rather than crafting it into html around the design.
    This is also true for the CMS.
    This means, amongst other things, that we can
    easily produce pdf/html/etc formats. I have lots of examples if people are
    interested in seeing it.
    Right this is a very interesting option. As I understood Cayenne is
    made to be easy for the end customer, a downloadable, complete PDF
    guide is probably not the badest idea.
    The main downside, is that all the docs need to be rewritten. And that's
    lots of lots of work. The best docbook editor available is Oxygen Author
    (not a free product).
    I have asked the Oxygen guy if they are willing to give out a few
    licenses to Apache people. Lets see, sometimes they do things like
    that.
    I'd be happy to set up the basic structure of the
    docs, the build scripts and a few pages. But I'll not have the time to
    rewrite all the pages. If the consensus is yes to docbook, I am happy to get
    the first part done.
    If the first part done, I guess the rest comes step by step. My guts
    say docbook might be a very good choice

    There are also Apache Forrest, Mvn Site, Piwi etc available for such
    tasks. But I think Docbook is the most stable and powerful tool out
    there. Mvn site is good, but also very basic.

    Cheers
  • Aristedes Maniatis at Apr 27, 2011 at 3:17 am ⇧

    On 26/04/11 4:31 PM, Christian Grobmeier wrote:
    There are also Apache Forrest, Mvn Site, Piwi etc available for such
    tasks. But I think Docbook is the most stable and powerful tool out
    there. Mvn site is good, but also very basic.
    My maven scripts actually use the maven 'site' goal to hook in the docbook construction. I don't know the details of what the Apache CMS uses for formatting, but assume it is textile/bbcode or something like that.

    The advantage of docbook is mainly that it is an established standard which is unlikely to change in the near future. The effort involved is not the migration to a new cms/svn/etc repository. It is changing Confluence style markup to something new. The less often we have to do that the better.

    I would propose that the site continue to stay in Confluence for now, and only the documentation (CAYDOC) move. Docbook is not a good format for blogs, news, website layout, etc.


    If there is general enthusiasm from the PMC over the next few days, I'll try and commit some basic scripts into our repo on the weekend.

    Ari


    --
    -------------------------->
    Aristedes Maniatis
    GPG fingerprint CBFB 84B4 738D 4E87 5E5C 5EFA EF6A 7D2E 3E49 102A
  • Gilbertoca at Jun 10, 2011 at 7:13 pm ⇧
    Hi,

    I know it is old post, but I would like to say what I've used[1] to
    convert[2] the old Apache Click docs (html) to new one (docbook) : herold
    [1] .


    Regards,

    Gilberto Caetano de Andrade
    Analista de Sistemas/DBA
    www.secad.to.gov.br
    http://blog.gilberto.com

    [1] http://www.michael-a-fuchs.de/
    [2] https://issues.apache.org/jira/browse/CLK-482

    --
    View this message in context: http://cayenne.195.n3.nabble.com/Maven-Use-of-objectstyle-org-maven2-repository-tp2833551p3050249.html
    Sent from the Cayenne - Dev mailing list archive at Nabble.com.
  • Aristedes Maniatis at Jun 11, 2011 at 10:16 am ⇧
    I did use that one (or the other converter I found, can't remember) to convert html to docbook. But the amount of cleanup at the end didn't seem to make it worthwhile. Particularly if we are going to rearrange things a bit during the migration.


    Ari

    On 11/06/11 4:52 AM, gilbertoca wrote:
    Hi,

    I know it is old post, but I would like to say what I've used[1] to
    convert[2] the old Apache Click docs (html) to new one (docbook) : herold
    [1] .


    Regards,

    Gilberto Caetano de Andrade
    Analista de Sistemas/DBA
    www.secad.to.gov.br
    http://blog.gilberto.com

    [1] http://www.michael-a-fuchs.de/
    [2] https://issues.apache.org/jira/browse/CLK-482

    --
    View this message in context: http://cayenne.195.n3.nabble.com/Maven-Use-of-objectstyle-org-maven2-repository-tp2833551p3050249.html
    Sent from the Cayenne - Dev mailing list archive at Nabble.com.
    --
    -------------------------->
    Aristedes Maniatis
    GPG fingerprint CBFB 84B4 738D 4E87 5E5C 5EFA EF6A 7D2E 3E49 102A

Related Discussions

Discussion Navigation
viewthread | post
Discussion Overview
groupdev @
categoriescayenne
postedApr 18, '11 at 8:52a
activeJun 11, '11 at 10:16a
posts8
users4
websitecayenne.apache.org

4 users in discussion

Aristedes Maniatis: 3 posts Andrus Adamchik: 2 posts Christian Grobmeier: 2 posts Gilbertoca: 1 post

Content

People

Support

Translate

site design / logo © 2022 Grokbase