Release Preparation

[Paul Zablosky]

Anastasia,
    I have started to create a table of contents page for the Fluid wiki 
pages that we might think of as comprising a "virtual manual" for the 
Fluid materials.  I propose to start with the pages labeled 'release', 
since these have already been selected as being related to the release 
items and the UX toolkit.   I'm wondering how this should coordinate 
with your intention to produce a set of links to starter pages.  It 
looks like the set of links you produce will be something I can include 
as a subset of my list.  Does that sound right to you?

I'm interested in getting input from people as to how to make a set of 
"virtual manual" links useful and usable.  As I indicated above, I'm 
envisioning structuring them as a table of contents, with a certain 
amount of explanatory information added.

Regarding the changing of the labels, would it make sense to just add a 
label of 'gateway' or 'topichead', and leave the existing 'release' 
labels in place?

Paul

Anastasia Cheetham wrote:
>> 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.
>
>   

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://fluidproject.org/pipermail/fluid-work/attachments/20080528/aa3992d5/attachment.html>