[
https://issues.apache.org/jira/browse/OFBIZ-4941?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13408321#comment-13408321
]
Tom Burns commented on OFBIZ-4941:
----------------------------------
Scott / Jacopo,
OFBiz developer resources are limited. They are now focused on slimming down
the project to a manageable scope. Given that fact, if it can be avoided, I do
not think it is a good time to open a discussion on the requirements of a help
system (never mind analysis, design and implementation).
There is wiggle room (* below) in the cat-x page but after reading some
(endless) post in legal-discuss on GPL I think it's best go just go with the
spirit of the law and forget about JavaHelp.
So for my part as per a prior post -
"If JavaHelp is not part of the solution then either the existing help system
would have to upgraded to display html or something different would have to be
built. I will look into that after I complete the HR documentation. "
Tom
*For example:
Wiggle 1
"Can Apache projects rely on components whose licensing affects the Apache
product?
Apache projects cannot distribute any such components. However, if the
component is only needed for optional features, a project can provide the user
with instructions on how to obtain and install the non-included work. Optional
means that the component is not required for standard use of the product or for
the product to achieve a desirable level of quality. The question to ask
yourself in this situation is:
'Will the majority of users want to use my product without adding the optional
components?'
Comment
OFBiz has a help feature. A new component supporting JavaHelp could be optional
implantation of an OFBiz help feature interface.
"Will the majority of users want to use my product without adding the optional
components?" Who knows!
Wiggle 2
Can Apache projects rely on components under prohibited licenses?
Apache projects cannot distribute any such components. As with the previous
question on platforms, the component can be relied on if the component's
license terms do not affect the Apache product's licensing. For example, using
a GPL'ed tool during the build is OK.
Comment
If build is OK why not run time?
> Proposal for a new help system
> ------------------------------
>
> Key: OFBIZ-4941
> URL: https://issues.apache.org/jira/browse/OFBIZ-4941
> Project: OFBiz
> Issue Type: Wish
> Components: ALL COMPONENTS
> Affects Versions: SVN trunk
> Reporter: Jacques Le Roux
> Priority: Minor
> Fix For: SVN trunk
>
> Attachments: HelpAccounting.jpg, HelpPerformanceReview1.jpg,
> HelpPerformanceReview2.jpg, HelpRoadmap.jpg, LICENSE.html, OFBIZ-4941 POC HR
> Help.patch, docbook-xsl-1.77.1.zip, jh.jar
>
>
> Quoting Tom Burns at OFBIZ-4869
> {quote}
> This is a status update just to let anyone who is interested know that this
> item is being worked on.
> I started out using the OFBiz structure for help docs but after a while I
> needed/wanted something more expressive.
> Here is what I wound up using for development:
> Java Help System http://java.net/projects/javahelp/content
> DocBook 5: The Definitive Guide
> http://www.docbook.org/tdg5/en/html/docbook.html
> http://www.docbook.org/xml/5.0/
> DocBook XSL: The Complete Guide
> http://www.sagehill.net/docbookxsl/index.html
>
> http://sourceforge.net/projects/docbook/files/docbook-xsl/1.77.1/docbook-xsl-1.77.1.zip
> Help Master - FE for managing java help files. Best feature drag and drop
> TOC creates TOC matching file folder structure. Convenient launcher for
> viewing & testing. http://www.halogenware.com/software/helpmaster.html
> XML Mind XML Editor - Free Personal Edition is far better then editing in
> Eclipse. download from http://www.xmlmind.com/xmleditor/download.shtml
> Tutorial - DocBook editing with XML Mind XML Editor. Worth going through
> http://www.xmlmind.com/xmleditor/tutorial.html
> Read Me First style guide from Sun (cost from Amazon 1 cent + shipping)
> Attached are some screen shots of the results.
> Every screen is/will be documented in a similar structure. This is as much
> for defining requirements and testing as for help. More work but worth it.
> The screenshots show a Java Help format generated using DocBook XSL. This
> will likely not be the final presentation format.
> Note the Performance Review screen shots do not match the trunk. There is a
> bug in update screen and I did some clean up of labels and drop-down list.
> There are issues like this all through the application so I did not want to
> get bogged down with patches at this time.
> {quote}
--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators:
https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira
