I hear that there is still friction between the Ubuntu Manual team and the Ubuntu Docs team.
I can’t see why, the wiki documentation is a great resource and while it has problems that stem from it being a wiki system, it’s been useful to me and to a lot of people I know. The most important parts of it are kept up to date even though it’s been criticised for becoming out of date too easily and for people to be mislead easily into following guides for older versions by mistake.
On the other hand the Manual team is new, brand new and has all the passion of a bright and eager team that might be able to make some nice documentation for Ubuntu which should be fairly easy to share back to the wiki and the Docs team in general. The manual team is also concentrating on a definitive, narrow band guide to be published on release for new users to get to grips with Ubuntu. It’s non rolling release really separates it from the Doc Team’s work and is perhaps a drawback in our ever changing work. But I think as long as each manual release is very clearly labelled, they should avoid that problem.
But even if the two teams end up sharing 90% of their content, the production of the result is where the work is going to be. I mean I think that some content from docs and manual is most certainly going to end up in some of the learning team’s classes and visa versa, but there is work there in each team which isn’t relevant to it’s peers. I don’t expect docs or manual to write quizzes or demonstration lesson plans for teachers, nor do I really expect the docs team to write all the tools and organise the compartmentalisation that will be required to produce a self contained manual.
It’s also likely that the intonation and pacing of each document source is going to be different anyway, just because the expectations are going to be different. We’re planning for, in the learning team, on being able to pull data in from other sources, but we don’t expect to be able to pull it in with a simple automated copy. It’s expected that an editor will have to go through it anyway.
What are your thoughts? Is there too much duplication? Is the manual project a sub-section of the Doc’s Team work?