incubator-ooo-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Jingbai <jingbaibe...@gmail.com>
Subject Re: Symphony documentation for AOO?
Date Fri, 16 Mar 2012 23:10:03 GMT
I think we could think about how to import the AOO help in xhp format into one of the Wiki
system that Apache supports. Since that would be the base for customization. Are there Urls
or docs for the wiki system? 

Betsy Bai

发自我的 iPhone

在 2012-3-16,下午11:09,Rob Weir <robweir@apache.org> 写道:

> On Fri, Mar 16, 2012 at 11:08 AM, Rob Weir <robweir@apache.org> wrote:
>> On Fri, Mar 16, 2012 at 4:11 AM, Jing Bai <jingbaibetsy@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 <jeanweber@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 <jingbaibetsy@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 <jeanweber@gmail.com>
wrote:
>>>>> 
>>>>>> On Sat, Feb 18, 2012 at 01:25, Jing Bai <jingbaibetsy@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
>>>>>> 
>>>> 

Mime
View raw message