forrest-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Dave Brondsema <d...@brondsema.net>
Subject Re: website documentation version
Date Thu, 04 Nov 2004 01:39:59 GMT
Nicola Ken Barozzi wrote:
> Dave Brondsema wrote:
> 
>> Nicola Ken Barozzi wrote:
>>
>>> Dave Brondsema wrote:
>>>
>>>> Quoting Nicola Ken Barozzi <nicolaken@apache.org>:
>>>
>>> ...
>>>
>>> I have thought now that probably it's best to do away with aliases 
>>> too, as it would generate two identical docs, and google would 
>>> 'dilute' the indexing on two identical versions.
>>>
>>>>> --------------------
>>>>> Source SVN space
>>>>> --------------------
>>>>>
>>>>> svn://forrest
>>>>>           /trunk
>>>>>              /site (the current website)
>>>>>              /docs (the current documentation)
>>>>>           /branches
>>>>>              /0.6
>>>>>                /site (the 0.6 website)
>>>>>                /docs (the 0.6 documentation)
>>>>>              /0.5
>>>>>                /site (the 0.5 website)
>>>>>                /docs (the 0.5 documentation)
>>>>>
>>>>>
>>>> The source space should only have /docs, not /site.  /site files 
>>>> should be in
>>>> the published SVN space.
>>>
>>>
>>>
>>>
>>> Oops, I have not been clear. With site here I mean site sources, like 
>>> was with the incubator CVS (or our trunk ATM).
>>>
>>>>> -----------------------------
>>>>> The published SVN space ...
>>>>> -----------------------------
>>>>>
>>>>> svn://forrest
>>>>>          /site (generated from svn://forrest/trunk/site)
>>>>
>>>>
>>>>
>>>>
>>>> Doesn't this need to be generated from some /docs directory, not 
>>>> some /site
>>>> directory?  These "main docs" are a whole forrest site, where is the 
>>>> source for
>>>> them held?
>>>
>>>
>>>
>>>
>>> I have used 'site' with two meanings, sorry.
>>>
>>> Here is a more clear naming (using Incubator SVN naming this time ;-):
>>>
>>> --------------------
>>> Source SVN space
>>> --------------------
>>>
>>> svn://forrest
>>>            /trunk
>>>               /site-author (the current website sources)
>>>               /docs-author (the current documentation sources)
>>>            /branches
>>>               /0.6
>>>                 /site-author (the 0.6 website sources)
>>>                 /docs-author (the 0.6 documentation sources)
>>>
>>
>> What is in site-author?  I'm confused.  Top-level documents?  Is there 
>> a site.xml in site-author and in docs-author?
> 
> 
> Yes, two different site.xml. Each of them is a separate indipendent 
> forrest site source.
> 
>  /site-author
>         forrest.properties
>         status.xml
>         content/**
> 
>  /docs-author
>         forrest.properties
>         status.xml
>         content/**
> 

Ok, I think I understand now.  At least enought that I'm okay with this 
being implemented.  We can continue to improve once we put something in 
place.

-- 
Dave Brondsema : dave@brondsema.net
http://www.splike.com : programming
http://csx.calvin.edu : student org
http://www.brondsema.net : personal

Mime
View raw message