From: "Jacopo Cappellato" <[email protected]>
On May 11, 2012, at 9:55 AM, Jacques Le Roux wrote:

This makes sense Scott!  We could even link the help from wiki online for 
demos. The problem is we use Confluence and its export
is known to be flawed and not supported/mantained anymore.

That is not related to what Scott was saying: the Confluence autoexport is 
related to the ability to transform a Confluence page
into a static html page.


I think it can be continued this way in the meantime.

I disagree that we should continue to add incomplete stuff to the trunk (and 
release branches) until a better design is in place.
This will not stop the huge effort of creating documentation and actual content 
for the help screens: contributors can do this in
Confluence (or similar) and then, when we will have defined a good design it 
will be easy to write a script to import the content
into the new format.

How to handle i18n automatisation in Confluence? Though yes, it's not really 
automated in online help as well, since we need to
create as much files as languages.

So should we revert, at least from releases?
What to do with current help content?

Opinions?

Jacques

Jacopo

We would then have a corpus of help to incoporate in the future wiki structure 
you proposed. Of course the earlier this structure
would exist the lesser work later...

Jacques

From: "Scott Gray" <[email protected]>
Is it intended that we will eventually have a content, dataresource and file 
for every screen in OFBiz and in multiple
languages?

I think we need to find a better approach than this, the committers can't 
maintain potentially thousands of help files and
records.  What about a wiki that we could run exports from, package up for 
download and then be deployed into OFBiz as needed by
users (or as part of the release process)?

Regards
Scott

On 11/05/2012, at 6:25 PM, Jacopo Cappellato wrote:


On May 11, 2012, at 8:14 AM, Jacques Le Roux wrote:

I did not close the Jira, wrork will be - hopefully - continued there.
I committed because it's already a decent work

You and I have definitely a different opinion of what is a "decent work" :-)

Jacopo

, I mean the structure is ready, I expect Pierre to fill it now...

Jacques

From: "Jacopo Cappellato" <[email protected]>
On May 11, 2012, at 12:03 AM, [email protected] wrote:

Author: jleroux
Date: Thu May 10 22:03:33 2012
New Revision: 1336921

URL: http://svn.apache.org/viewvc?rev=1336921&view=rev
Log:
A patch from Pierre Smits "Help screens in Manufacturing" 
https://issues.apache.org/jira/browse/OFBIZ-4802

Fix the help screens of Manufacturing

jleroux: We maybe need to think about the components order in help

I hate this commit: it simply adds a bunch of placeholder records. In my 
opinion an help screen should be added when it is
complete or at least it has some meaningful text inside.

Jacopo





Reply via email to