Documentation Stable Release Updates

[Phil Bull]

Hi Matt,

On Sun, 2008-01-20 at 19:24 +0000, Matthew East wrote:
> > I'd like to move ahead with this. Would you like me to contact the
> > release team and ubuntu-translators to get their input?
> 
> As long as we are staying within the existing release schedule (which
> as I under the idea, we are) then there shouldn't be a need to get
> clearance. Let's draw up a wiki page and set out the details of the
> idea. Then we can refine it and perhaps implement it for hardy.

The issue is that we'd be releasing the changes to a previous release
rather than the current development focus, so would need clearance to
get the package into -updates for that release. Would you recommend that
we try to push the package through the normal SRU process [1]? If so,
the service pack wouldn't really fit the SRU requirements, as it would
generally be non-critical.

I've created a wiki page with a rough outline here [2].

> > > I'm not keen on only updating the website, I think that if we're going
> > > to go to the effort, we might as well go the whole way.
> >
> > I agree. What is currently involved in updating the website?
> 
> It involves rebuilding the documents for a particular release and then
> asking the webmaster to upload them. It's more difficult for the first
> update of the website for each release, because that involves
> rebuilding every release with new tabs... A website update shouldn't
> be much more effort than updating the package really.

It would be possible to use Server-Side Includes to define a standard
header for all of the pages. This header could then be updated
independently, removing the need to rebuild the docs for each release.
This would have to be enabled on the web server though.

Thanks,

Phil

[1] - https://wiki.ubuntu.com/StableReleaseUpdates
[2] - https://wiki.ubuntu.com/DocumentationTeam/ServicePacks

-- 
Phil Bull
http://www.launchpad.net/people/philbull