OK, sorry to have messed things up. https://issues.apache.org/jira/browse/OFBIZ-2133 tries to use the Confluence END-USER space as it is now and just to link it to OFBiz. This is, IMO, the shortest path to have a well structured and updated documentation. This will happen because the help pages will be much more handy and if a help page is not available or not updated it will come soon up evident. We should only to decide hot to structure the help pages. IMO the current pattern to have one page for each OFBiz page is really good. We should have at least this and then add some more general pages.
https://issues.apache.org/jira/browse/OFBIZ-2133 also foresees an help package distribution to be used offline locally. This will be really easy to do using the Confluence export feature (that is available right now). So I definitively suggest to go on this path. "use our own dog food" is another thing that we have discussed and agreed to be beneficial to the project (CMS application further development). This is a task that Hans as already started putting a copy of the OFBiz web site into OFBiz itself but this effort will be dead soon if we do not decide if and how to use it. A possibility that I see is that, after having found the server and infra needed, OFBiz could be used to host only the web site. This will allow/need a CMS improvement. Then when we will have a CMS that we can rely on (or, may be better, that we have learned to use) we could move the help documentation on it. -Bruno 2009/2/8 Jacques Le Roux <jacques.le.r...@les7arts.com>: > 1) Drupal is a true CMS, OFBiz is only a kind of documents managment system. > I guess it would be much more difficult to achieve the same result, no > speaking about maintening it... > 2) This is contradictory with your proposition in > https://issues.apache.org/jira/browse/OFBIZ-2133. If we switch from > Confluence to OFBiz CMS, how will you achieve your proposition there ? > > Jacques > > From: "Bruno Busco" <bruno.bu...@gmail.com> >> >> An example of a self-hosting documentation: >> http://drupal.org/handbooks >> >> Would be great to have for OFBiz ! >> -Bruno >> >> 2009/2/8 Jacques Le Roux <jacques.le.r...@les7arts.com>: >>> >>> Hi Jacopo, All, >>> >>> Looks great : simple! And the way you presented things look more like >>> documentations of other reputed Apache TLP Projects (Geronimo, >>> ServiceMix, >>> etc.) >>> I think we still have an effort to do in order to present things in Wiki >>> like if OFBiz was an easy thing to play with (wich is false but that's >>> marketing, isn'it ? ;o) >>> We should try to put more effort in documentation : removing old stuffes, >>> simplyfing, *ordering*. Look for instance at ServiceMix >>> http://servicemix.apache.org >>> It looks very easy to use, isn'it (after reading a couple of pages it's >>> the >>> impression I got) ? And we know it's not! >>> What we need most is efforts coordination, to try to put something like >>> these other projects in place (a sort of book with ordered, easy to find, >>> pages) >>> Our documentation looks terrible in comparaison http://docs.ofbiz.org or >>> even http://docs.ofbiz.org/pages/listpages-dirview.action?key=OFBENDUSER >>> How could we achieve it ? Not having the Confluence export available (is >>> that true?) should not be a reason. >>> We have already discussed about that, and if I recall correctly the last >>> option was to use our own dog food. But is that possible ? Shall we >>> really >>> able to achieve this in a reasonable time duration ? >>> >>> Also Bruno is proposing something very interesting about help >>> https://issues.apache.org/jira/browse/OFBIZ-2133 >>> >>> Thanks to have read me so far, waiting for your opinions :o) >>> >>> Jacques >>> PS : I intentionnaly don't post this in user ML, I don't expect much from >>> users at this stage... >>> >>> From: "Jacopo Cappellato" <jacopo.cappell...@hotwaxmedia.com> >>>> >>>> Ooops, sorry, here is the link: >>>> >>>> http://docs.ofbiz.org/display/~jacopoc/Hello+World%21 >>>> >>>> Jacopo >>>> >>>> On Feb 8, 2009, at 9:53 AM, Jacopo Cappellato wrote: >>>> >>>>> Hi all, >>>>> >>>>> you may be interested in this "experimental" new "Hello World!" >>>>> tutorial, that makes use of the new "create-component" target to setup >>>>> the >>>>> layout of a new component. >>>>> I really think that the OFBiz framework is becoming very powerful: >>>>> writing an "Hello World!" application is really a matter of writing >>>>> "Hello >>>>> World!" inside of a "label" element in a screen definition. >>>>> >>>>> Cheers, >>>>> >>>>> Jacopo >>>>> >>>> >>>> >>> >>> >> > >
