On Fri, Mar 16, 2012 at 7:26 PM, Guy Waterval <waterval....@gmail.com> wrote: > Hello Betsy, > > > 2012/3/16 Jing Bai <jingbaibe...@gmail.com> > >> Seems many people would agree that WIKI solution is a good one. Does anyone >> know where we can find the WIKI hardware and platform resources in our >> community? How could we setup one wiki platform for ourselves to host the >> help? >> > > Concerning this question of documentation, I totally subscribe with the > position of Jean Weber when she says : > > [Citation] : I also think many of the volunteers who worked on user > guides for OOo -- if they choose to work on AOO docs -- prefer to work in > AOO itself and produce user guides that demonstrate (some of) what one > can do with the product as a publishing system. [End of citation] > > Moreover, I think that the choice of the wiki or the DITA format would > introduce a technical barrier which would strongly reduce the number of > volunteers. Please, consider that such a group as the LO fr group, which > has began to translate the LO oooauthors docs, seems to have some > difficulties to reach the necessary team to do the job. For me, the number > of people involved does nos exceed 4 or 5. This can give you an idea of the > difficulty to create a documentation team of volunteers, even when working > with a well known method. >
The format isn't the issue. The issue is the editing environment, right? If you could use OpenOffice as your editor and easily save it to DITA, or Wiki format, then that would be OK. Do you agree? If so, I think there are three questions to consider: 1) What editing environment(s) should we support? 2) What format should we use for storing the documentations in its richest (fullest) form? 3) What publication format(s) should we publish the documentation in? If I understand the way the ODFAuthors are working, the choices were: 1=OpenOffice, 2= ODF, 3=PDF. Is that correct? Jinbai, how is it for Symphony? 1=?, 2=DITA, 3= Wiki ? -Rob > Of course, if the community choose another way, I will try to participate, > even if I never have worked with a wiki. > > A+ > > -- > > gw
