[
https://issues.apache.org/jira/browse/OFBIZ-6450?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14593970#comment-14593970
]
Taher Alkhateeb commented on OFBIZ-6450:
----------------------------------------
Aha! this clears things up nicely Sharan. Thank you for the effort.
Okay on a first glance I think the solution to have an FTL template for web
help is ugly and we're reinventing the wheel with it. I think we can probably
improve performance in a cleaner way if we focus on it.
Do you know if the old implementation is done with Xalan? Maybe we can do
transformations with saxon or perhaps we can investigate the bottlenecks in
performance and resolve those. Do you have any code references or places to dig
into in the repository to avoid working from scratch?
> Docbook and OFBIz Online Help
> -----------------------------
>
> Key: OFBIZ-6450
> URL: https://issues.apache.org/jira/browse/OFBIZ-6450
> Project: OFBiz
> Issue Type: Bug
> Reporter: Sharan Foga
> Assignee: Sharan Foga
> Attachments: 02-docbook_overview_diagram.pdf, humanres.xml
>
>
> Jira created based on the steps suggested by Taher as follows:
> - First, we attempt to fix whatever is wrong in DocBook at the moment. If you
> can share exactly what you spotted then this would save us a lot of time in
> trying to dig to the problem. So a repeat process to identify the bugs from
> you would be great.
> - Second, we decide on a category structure for the sections of the
> documentation if we do not like the existing one
> - We also introduce or enforce a workflow that mandates an update of the
> documentation on each JIRA that affects functionality that requires
> documentation. For example, if we add or modify a screen in the party
> component, then we must provide the documentation for that screen before
> closing the JIRA for example.
> - As a last step we decide on the appropriate technology to move forward.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
