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.

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