On Fri, Mar 16, 2012 at 11:08 AM, Rob Weir <robw...@apache.org> wrote: > On Fri, Mar 16, 2012 at 4:11 AM, Jing Bai <jingbaibe...@gmail.com> wrote: >> 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? >> > > At Apache we have access to ConfluenceWiki and Media Wiki systems. > What does your help system use? Is there any way to export or convert > the help so it works with one of these systems? >
I think Apache supports MoinMoin wiki as well, though we don't currently use it in this project. > -Rob > >> Best regards >> Betsy Bai >> On Wed, Feb 29, 2012 at 12:05 PM, Jean Weber <jeanwe...@gmail.com> wrote: >> >>> I haven't had time to look at the tutorials themselves, but the list >>> of contents looks very good. I would definitely like to see them >>> become part of the official user documentation for AOO. The main >>> questions for the group are when and where these materials will be >>> available for volunteers to work on them, and who is going to do the >>> actual work of updating them for AOO. >>> >>> I will say right now that I am not going to be the person coordinating >>> the work (on these or other user-oriented documents), nor do I intend >>> to do much if any of the work myself. I'm asking questions in the hope >>> of nudging others into action, but beyond that I don't intend to go. >>> (Of course, I might change my mind later, but don't count on it.) I >>> have books of my own to write, and limited time for writing. >>> >>> --Jean >>> >>> On Mon, Feb 20, 2012 at 16:25, Jing Bai <jingbaibe...@gmail.com> wrote: >>> > Regarding on the user guide, actually, we have some getting started >>> > tutorials for Symphony before. Here is the link, maybe this is a >>> reference >>> > for our AOO user guide? The guide is a tutorials that help user to >>> getting >>> > started. Not all the help topics would be listed but some key one. >>> > >>> > Document tutorials: >>> > >>> http://www-03.ibm.com/software/lotus/symphony/idcontents/tutorial/en/documents_tutorial/frameset.html >>> > Presentation tutorials: >>> > >>> http://www-03.ibm.com/software/lotus/symphony/idcontents/tutorial/en/presentations_tutorial/frameset.html >>> > Spreadsheet tutorials: >>> > >>> http://www-03.ibm.com/software/lotus/symphony/idcontents/tutorial/en/spreadsheets_tutorial/frameset.html >>> > >>> > Thoughts? >>> > >>> > On Sat, Feb 18, 2012 at 5:19 AM, Jean Weber <jeanwe...@gmail.com> wrote: >>> > >>> >> On Sat, Feb 18, 2012 at 01:25, Jing Bai <jingbaibe...@gmail.com> wrote: >>> >> > The wikis we use are xpages wikis that run on Domino servers. USA IDC >>> >> hosts >>> >> > the WIKI for all Lotus products, such as Lotus Connections, LotusLive, >>> >> > Symphony, Sametime and etc. There is a STSM named John Hunt who wrote >>> the >>> >> > code to transform DITA into DXML (the xpages source code) for wiki >>> pages. >>> >> > Here is one demo on how we publish the product documentation in Wikis: >>> >> > >>> >> >>> http://cdcontent.lotus.com/lotused/lnl_doc-to-wiki_enablement/lnl_doc-to-wiki_enablement.htm >>> >> > >>> >> > Publishing product documentation in wikis lets us provide accessible >>> >> > documentation in a friendly and easy-to-use format where customers can >>> >> > comment directly against topics and even update the instructions. >>> Writers >>> >> > can review that feedback and incorporate appropriate changes into >>> source >>> >> > files for the next product release. Using wikis lets IBM consolidate >>> >> > product information while fostering a greater sense of community >>> between >>> >> > IBMers, business partners, and customers. >>> >> > We may reuse the WIKI platform in USA IDC, setup one area for AOO if >>> >> > necessary. I would like to ask USA IDC, if this is feasible. >>> >> > >>> >> > >>> >> > On Fri, Feb 17, 2012, Jing Bai wrote: >>> >> > >>> >> >> In the future, we would like to promote the WIKI help console to the >>> >> >> community if appropriate. Since it is more collaborative, but to >>> make it >>> >> >> happen, the file format would be changed into DITA, if anyone is >>> >> >> interesting in it, I would like to provide an article on its details. >>> >> >>> >> >>> >> Betsy, >>> >> Thanks for your replies. >>> >> >>> >> I think the wiki solution is a good one (especially since most of it >>> >> exists now and only needs to be revised for AOO), so I hope it can be >>> >> set up and interested people can learn how to use it. Several new >>> >> members of the group have expressed interest and even experience in >>> >> working with DITA. >>> >> >>> >> However, 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. So there is scope for the >>> >> online docs and user guides. The user guides could be derived from the >>> >> online docs (with an Apache license) or derived from the existing OOo >>> >> docs (with a CC-BY license and probably hosted elsewhere, as discussed >>> >> some time ago on this list). >>> >> >>> >> Aside: I know that it is possible to produce book output from DITA >>> >> files, but in my experience online material doesn't always produce the >>> >> most useful content for a sequential document like a book. In other >>> >> words, the issues are editorial, not technical. >>> >> >>> >> Which way we go, and indeed whether people want to do user guides at >>> >> all, depends on who wants to get involved. For the record, I much >>> >> prefer to work in AOO itself, but I am interested in learning about >>> >> the DITA/wiki system and investigating content reuse possibilities. >>> >> >>> >> --Jean >>> >> >>>