Developer review of documentation
Jonathan Jesse
jjesse at iserv.net
Fri Dec 1 17:47:09 UTC 2006
> On Tue, Nov 28, 2006 at 11:13:45AM -0000, Matthew East wrote:
>> > There is no formal process in place for this yet, as far as I know,
>> but it
>> > is needed. I can arrange developer resources to review documentation
>> > for correctness before it is published as official.
>> >
>> > Doc team: how do you want this to work?
>>
>> We did some ad-hoc asking developers to review documentation during the
>> Dapper release cycle and it worked well. Here's what I propose we do.
>>
>> The documentation team has a number of tasks which it needs to look at
>> shortly before string freeze. For example, proof reading, checking menu
>> entry consistency, and so on. Asking developers to review key
>> documentation for correctness could form part of this process. I suggest
>> we do it 2 or 3 weeks before string freeze.
>>
>> We'd need to make a list of the key documentation to be reviewed (this
>> could include key system documentation, *and* key wiki pages), and
>> potentially identify the relevant developers who might be able to lend a
>> hand.
>>
>> How does that sound as a vague plan?
>
> I think that we need to allow time to revise the documentation if
> necessary
> before string freeze, and ideally there should be multiple batches of
> review
> during the release cycle. This seems like a logical fit for development
> milestones; at each milestone we should arrange review of any new or
> substantially changed documentation.
>
> --
> - mdz
>
> --
> ubuntu-doc mailing list
> ubuntu-doc at lists.ubuntu.com
> https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc
>
>
As long as we all don't wait for just before string freeze to suddenly
throw all the docs together like seems to happen too often.
If we want the docs to be reviewed before release we need to make sure
there aren't a slew of exceptions to feature-freeze and any other freeze
that would affect what is in the documentation. If there is a new
application or major change to something via an exception, we will then
have to document that change, get it reviewed and then released. It seems
like it could delay the whole process.
--
Jonathan Jesse
More information about the ubuntu-doc
mailing list