For those who are interested to see the final (incomplete) result, done at https://svn.apache.org/repos/asf/ofbiz/branches/webhelp-2012-12-07 Changes from trunk HEAD are at http://svn.apache.org/viewvc?rev=1418622&view=rev
Jacques From: "Jacques Le Roux" <jacques.le.r...@les7arts.com> > For the major reason you know, I will commit this work in a branch for now > > Jacques > > From: "Jacques Le Roux" <jacques.le.r...@les7arts.com> >> From: <adrian.c...@sandglass-software.com> >>> Scott, >>> >>> I agree with your last paragraph and I have suggested it in the past, >>> but there doesn't seem to be much interest in it. There is a much >>> simpler way to implement help that addresses all of our concerns: >> >> Maybe and this could replace/improve what Tom proposed, but why wait or >> reject the current work? >> >>> 1. Put Help URLs in the UI label files so they can be localized. >>> 2. Use the Content component to store and display Help data. >>> 3. Have each component initialize the database with Help data. >> >> Maybe a POC could show the result and would make us able to compare with the >> current proposition >> Of course not only in term of result but also of architecture. >> >>> OFBiz OOTB could have some Help screens available in the Content >>> component, but if a user wanted to use some other method, all they >>> would need to do is change the Help URLs in the UI label files (to >>> point to an internal Wiki for example). >> >> The same can be achieved by Tom's proposition IIRW. It's just a matter or >> changing an URL >> >> Jacques >> >>> -Adrian >>> >>> Quoting Scott Gray <scott.g...@hotwaxmedia.com>: >>> >>>> I haven't had time yet, I was on a computer-free vacation last week >>>> and now have a ton to catch up on. >>>> >>>> I've read the pdf document but it's light on implementation detail >>>> so I guess I'll have to dig into the patch at some point. >>>> >>>> Thoughts/questions so far: >>>> - The build time compilation is a concern IMO, I'd like to see a >>>> help system that users can edit as needed with things like business >>>> specific information and filling in gaps for custom enhancements >>>> that the devs didn't document fully >>>> - I think I saw somewhere that it is planned to commit the generated >>>> help html? Why? Version control is for source code. >>>> - How would this approach work in multi-tenanted systems where not >>>> all apps are available to all tenants? If help is a complete >>>> document I'm not sure how it could be restricted by context? >>>> >>>> I think it's important to make a distinction between the >>>> 'prettiness' of the proposed implementation and the underlying design. >>>> >>>> I also think it's unfortunate that we're unable to eat our own dog >>>> food and use the content app properly given that documentation is >>>> ultimately content embedded within OFBiz. It's a great use-case for >>>> improving the content app really. >>>> >>>> Regards >>>> Scott >>>> >>>> On 4/12/2012, at 7:58 AM, Olivier Heintz wrote: >>>> >>>>> I have tested the new OFBIz webhelp for the last 3 weeks and migrated >>>>> some help we already have (for projectmgr) >>>>> >>>>> On a end user perspective, webhelp is clearly an enhancement, because >>>>> search and glossary (and better presentation) help to find the correct >>>>> information more quickly. >>>>> On a help writer perspective, docbook file structure is easier to >>>>> understand that dataresource - content - contentAssoc - ... >>>>> >>>>> There are still some minors problems, but in each case I have found >>>>> (with Tom help sometime) how to solve it. >>>>> >>>>> I'm waiting a first release is publish to trunk to send jira with these >>>>> enhancements. >>>>> >>>>> User Help is one of the software quality criteria and webhelp will help >>>>> ofbiz community to have better one. >>>>> Tools is not everything, but it's a good step to motivate the community >>>>> to contribute in this area. >>>>> >>>>> >>>>> Le 28/11/2012 19:22, Jacques Le Roux a écrit : >>>>>> Bump ? >>>>>> >>>>>> Jacques >>>>>> >>>>>> Jacques Le Roux wrote: >>>>>>> Yes no problems. Depending on what you are starting from, you >>>>>>> will need to add binaries files (from my last patch) or not (Tom's >>>>>>> zips) but with zips you might get some issues, already blurred in my >>>>>>> mind. >>>>>>> >>>>>>> Thanks >>>>>>> >>>>>>> Jacques >>>>>>> >>>>>>> From: "Scott Gray" <scott.g...@hotwaxmedia.com> >>>>>>>> It's been all of 3 days since I asked you to wait for a thorough >>>>>>>> review, has that happened yet or will you just keep asking >>>>>>>> until no one can be bothered asking you to wait any longer? >>>>>>>> Patience is a virtue Jacques, the project has gone over 10 years >>>>>>>> without this feature and I don't think a few days/weeks/months >>>>>>>> will hurt any, especially considering the next release branch >>>>>>>> isn't due to be created for quite some time. >>>>>>>> >>>>>>>> Regards >>>>>>>> Scott >>>>>>>> >>>>>>>> On 19/11/2012, at 8:41 AM, Jacques Le Roux wrote: >>>>>>>> >>>>>>>>> Hi, >>>>>>>>> >>>>>>>>> We (Tom and I) are ready to commit the new help (webhelp - >>>>>>>>> OFBIZ-4941) in the content component where all work for us, and >>>>>>>>> will >>>>>>>>> be completed by Tom as he suggested. There are some trivial >>>>>>>>> Birt issues which will dissapear when the process will be >>>>>>>>> completed, see my last comment. >>>>>>>>> >>>>>>>>> Is it ok to commit as is and to improve later? Mostly we want >>>>>>>>> to move webhelp outside of the content component in a new, to >>>>>>>>> stay OOTB, specialpurpose webehlp component. Or do you want >>>>>>>>> this addressed before? Note that if you want this addressed now >>>>>>>>> we >>>>>>>>> expect a rapid help from those who want that... >>>>>>>>> >>>>>>>>> Thanks >>>>>>>>> >>>>>>>>> Jacques >>>>> >>>> >>>> >>> >>> >>> >> >