Release Preparation

[Anastasia Cheetham]

> On May 27, 2008, at 8:31 AM, Anastasia Cheetham wrote:

>> Wiki pages marked with the label "release" will be included in the
>> distribution (in the generated PDF file).


On 27-May-08, at 7:47 PM, Daphne Ogle wrote:

> Since the UX wiki sections will not be part of the pdf file do we  
> need to go in remove the tags from all those pages?

Daphne, thanks for raising this point.

Last night at the technical planning meeting, we discussed  
documentation for the release, and the new plan is this:

We will not be generating a PDF snapshot of the wiki. We will create a  
copy of the API and tutorial pages that apply to the particular  
release (since the API documentation is specific to a release) but for  
the rest of the documentation, we are going to create a single HTML  
page that will contain links to relevant starter pages in the wiki.

Given this new model, the task is to decide what are the relevant  
starter pages in the wiki :-) We will probably change the meaning of  
the 'release' label, and apply it only to the pages that will be  
linked to directly from the HTML documentation. Then the label can be  
used by whoever creates the HTML page to know what links to include.

Unfortunately, this will require us to remove the 'release' label from  
a lot of wiki pages, and leave it only on pages that should be  
considered gateways to particular topics. If we look at the structure  
of the PDF that was included in the beta release, that could give us  
an idea of what those gateway pages might be.

I'm sorry for the inconvenience of having to remove the 'release'  
labels. We're learning how to streamline the release process as we go,  
so we appreciate your patience as we work through some growing pains.

-- 
Anastasia Cheetham                   a.cheetham at utoronto.ca
Software Designer, Fluid Project    http://fluidproject.org
Adaptive Technology Resource Centre / University of Toronto