ofbiz-notifications mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Taher Alkhateeb (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (OFBIZ-9873) Create a PoC for a documentation system for OFBiz based on Asciidoc
Date Sun, 11 Mar 2018 09:01:00 GMT

    [ https://issues.apache.org/jira/browse/OFBIZ-9873?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16394458#comment-16394458
] 

Taher Alkhateeb commented on OFBIZ-9873:
----------------------------------------

Ok, so checking the dependencies of the system, asciidoctorj pulls in "org.jruby:jruby-complete:1.7.26"
so we will be jumping many versions. It also seems like this issue is quite common in windows
(issues with JRuby).

Did you test the dependency override? Does it seem to be behaving well on your computer? Did
you get both HTML and PDF outputs?

> Create a PoC for a documentation system for OFBiz based on Asciidoc
> -------------------------------------------------------------------
>
>                 Key: OFBIZ-9873
>                 URL: https://issues.apache.org/jira/browse/OFBIZ-9873
>             Project: OFBiz
>          Issue Type: Improvement
>    Affects Versions: Upcoming Branch
>            Reporter: Taher Alkhateeb
>            Assignee: Taher Alkhateeb
>            Priority: Minor
>             Fix For: Upcoming Branch
>
>         Attachments: OFBIZ-9873.patch, OFBIZ-9873.patch
>
>
> In reference to the [discussion thread|https://lists.apache.org/thread.html/8cc03b7b8733512244129ddae9e0cc1fb2a28e3e250aba1c8cf678f8@%3Cdev.ofbiz.apache.org%3E]
this is an attempt to create a PoC for OFBiz documentation system based on Asciidoc. The main
assumptions for the design of this system are:
> - The documentation language to use is Asciidoc
> - The documentation tool is Asciidoctor
> - Publishing happens through Gradle using the asciidoctor gradle plugin (not the OFBiz
framework or anything else).
> - The only place where we write documentation is inside the code base
> - Every component contains its own documentation
> - General documentation goes to either a standalone directory or a generic component
like common or base
> - As much as possible, documentation files are small and focused on one topic. And then
other longer documents are constructed from these snippets of documentation.
> - We publish to all formats including PDF for users, or HTML for embedded help and wiki
pages. So OFBiz does not parse docbook for its help system, instead it just renders generated
HTML.



--
This message was sent by Atlassian JIRA
(v7.6.3#76005)

Mime
View raw message