This part is a place to collect some discussion about the relationship between user documentation and other user support services. Please add your comments below, and please send them to the ooo-dev list as well.

Rob Weir wrote on the ooo-dev list:

I'd urge you to think boldly about what we could do. I know we don't have the resources currently to do much more, but the truth is we don't get the resources until we articulate a vision about what we could do. If we have a compelling vision, then we can try to entice volunteers, corporate sponsors of editors, etc.

So if resources were not an issue, what would we do? What could we do? How could a fully resourced doc effort best contribute to the overall success of the project and our users?

And in a follow-up note:

My general view is this: After 10 years of OpenOffice.org we have about as many volunteers as the status quo will ever get us. If
someone is really interested and able to contribute to the project, they either are doing so already, do doing so for LibreOffice. This is due to the great work OOo did over the years raising awareness of the project.

The move to Apache changes things somewhat. The project is now a community-led project, not a corporate-led project. It now has a
permissive license. This changes the equation and could bring in some new contributors. I think this will mainly be new
corporate-sponsored contributors. Not exclusively, but the changes that the move to Apache will bring will be particularly attractive to such contributors.

If we want to do better than that, then we need to do more then the status quo. We cannot just do the same things and expect better results. We need to do more than just migrate/translate/rehost/move OOo to Apache. We need to up our game. This requires more volunteers, of course. But the magic is, by expressing a bolder vision we can attract the kinds of volunteers that can make this happen.

Ask yourself, if you were not already involved, and had a history with the project, what would interest a person of your skills in
volunteering? That's the kind of person we want to attract!

I'm not a documentation expert, but I've noticed some trends:

Moves to using structured formats that allow content to be more easily sliced and diced and targeted to different outputs. DITA is one way of doing it, but similar approaches could be based on ODF.

Collaboration with users. Several companies do this their online doc. Each page allows comments, a thread at the bottom of the page for user's to enter additional observations, tips, corrections, etc.

Multi-media. It is amazing what a 30 second video clip can teach you about pivot tables that would take pages of text to explain.

Tightening the bounds between documentation, product help, support and training. That goes back a to 1) above, the structuring of the information to make it reusable.

Would things like the above attract more interest?

To which Jean Hollis Weber responded, in part:

I agree with your points above....

Whether overtly working towards those goals would attract more interest from appropriately-skilled people, I can't guess. Certainly
(3) would attract people who aren't motivated toward print media. We've had intermittent interest at OOo over the past few years, but nothing's ever come of it. I think it was mainly from people who wanted to do multimedia but didn't really know much about it, and there was no one to act as a mentor to the others.

.....

I've been looking at the Symphony documentation wiki 1 and am impressed with it as a good example of one important type (subset) of user documentation: what I would call well-organised and searchable how-to's. I particularly like the way there is a set of original non-editable docs and a set of editable docs derived 1-to-1 from the original docs, each set with clear links to the other. 2 is an example. As mentioned in your point (2), the pages offer an opportunity for readers' comments as well as direct editing. This overall approach seems to me to meet the requirements of both camps regarding end-user docs: controlled "official" docs, plus an immediate opportunity for community participation. (I haven't looked around enough to see how someone might offer a new page of info, not just respond to existing pages, but I'm sure it's there.)

1 Comment

Have been working regularly on an OpenOffice user guide aimed at the students of our university here in Frankfurt. It's about 50 pages, and I update it more or less on a monthly basis to fit in student feedback.

Have now translated it into English. But don't know where to "put" it on the net, so others might benefit from it.