2013/1/4 Rob Weir <robw...@apache.org> > On Thu, Jan 3, 2013 at 8:15 PM, RGB ES <rgb.m...@gmail.com> wrote: > > Hello, list > > > > Maybe we can start to discuss how the documentation for AOO 4 will be > > organized, going on with a long discussion we had on the dev mailing > > list(1). > > > > IMO, there are three main topics that needs to be addressed: > > > > * Bundled help: As previously mentioned on this list by Pedro Giffuni, > the > > online help system is really useful but it needs a lot of love. I have no > > idea how those help pages are build... If someone on the list know how > all > > this work (how new pages are created, how existing ones are modified...) > > please start a new thread with some pointers. > > > > * Web help: Build a full documentation on the wiki that can be used as > > reference for any documentation effort. As I mentioned on the DEV list, > on > > the ES wiki we started an experiment(2), and based on this I wrote a > > "proposed TOC" draft(3). > > > > * Books, either printed or as distributable PDFs. Content for this can be > > worked from the previous point, but we need to define templates, for > > example. > > > > Wikipedia has the ability to export MWiki pages to ODF format. It is > part of their "Book creator" feature. (They can also export to PDF). > Would something like help? Or do we need more control over layout and > formatting? >
That depends on how the odt document is created: if styles are used, there is no problem, just a bit of work to redefine the styles and everything will be OK. Maybe cross references between pages could be a bit problematic... but nothing that a good search&replace cannot sort, IMO. Regards Ricardo > > -Rob > > > > Anything else? > > > > (1) http://markmail.org/message/tnxe66xxmad6njhq > > (2) http://wiki.openoffice.org/wiki/ES/Manuales/GuiaAOO > > (3) > > > https://cwiki.apache.org/confluence/display/OOOUSERS/Details+on+Scenario+3#DetailsonScenario3-ProposedTOC > > > > Regards > > Ricardo >
