On Wed, Sep 25, 2013 at 6:43 PM, Kay Schenk <kay.sch...@gmail.com> wrote:

> On Wed, Sep 25, 2013 at 1:49 PM, Rob Weir <robw...@apache.org> wrote:
>
> >
> >
> http://www.pcworld.com/article/2048446/apache-openoffice-4-0-review-new-features-easier-to-use-still-free.html
> >
> > Title is "Apache OpenOffice 4.0 review: New features, easier to use,
> still
> > free"
> >
> > We get 4.5 of 5 stars.  The reviewer says AOO 4.0 is "smooth and
> > cohesive" and gives good coverage to the new sidebar.
> >
> > However we are dinged a little for the "documentation" (I think he
> > means the in-product help files) which is described as "sparse, and
> > not well-aimed at non-technical users".   I wonder if there is
> > something we can do to link in more of the tutorial/overview material
> > that exists?
> >
> > -Rob
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: dev-unsubscr...@openoffice.apache.org
> > For additional commands, e-mail: dev-h...@openoffice.apache.org
> >
> >
> I'm sure there is. I took a look at what's available to guide one of our
> newest volunteers who might be interested in contributing to this. There is
> a 108 page document on the help files! I'm sure it's useful but probably
> VERY daunting when it's likely making changes to the help files isn't
> necessarily so.
>
> Also, given my own experience of late with the internal help files, I'm not
> happy with the results produced by the "Find", and wonder how we can get
> more hits for keywords that should yield some better results.
>
> Long story short, we do need to expend some effort in the near future (
> goal of mine anyway) to tutorials/guidelines on the help system -- how it
> works, how to add to it, etc. This is really an area of "documentation" in
> my mind, even though it is internal. Volunteers with some technical writing
> expertise would be very valuable in this area.
>
> --
>
> -------------------------------------------------------------------------------------------------
> MzK
>
> "Truth is stranger than fiction, but it is because Fiction is obliged
>  to stick to possibilities. Truth isn't."
>                              -- "Following the Equator", Mark Twain
>

​I think it would help people if we have a more wiki-like navigation of the
documents as opposed to the old chm model.
Things like tag clouds, tutorials and better used of integrate it with a
knowledgebase​ like the FAQ engine that was generated on the wiki
documentation website.


-- 
Alexandro Colorado
Apache OpenOffice Contributor
http://www.openoffice.org
882C 4389 3C27 E8DF 41B9  5C4C 1DB7 9D1C 7F4C 2614

Reply via email to