Ivy site

[Maarten Coene <ma...@yahoo.com>]

Hi all,

within a few hours, an updated Ivy site should be online where the general part 
should fulfill most of the requirements listed here: 
http://www.apache.org/foundation/marks/pmcs

I didn't update the documentation belonging to the Ivy releases though, which 
means that a lot of pages won't follow these requirements. I can regenerate all 
this historical content as well to make sure the updated headers/footers/logo's 
are shown. However, this won't change any content on these pages, so they will 
still use 'Ivy' instead of 'Apache Ivy' for instance. 


A concrete example:
http://ant.apache.org/ivy/history/latest-milestone/index.html

This index.html has been generated from the tagged index.html in SVN:  
https://svn.apache.org/repos/asf/ant/ivy/core/tags/2.2.0/doc/index.html

The first sentence is: "Welcome to the official Ivy documentation."
According to the new requirements, this should be: "Welcome to the official 
Apache Ivy (TM) documentation."

So if I want to change this sentence, I have the change the tag. The 
headers/footers are not a problem, they are regenerated when the site is 
generated, the problem is the content only.
How should I deal with this?

regards,
Maarten


      

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
For additional commands, e-mail: dev-help@ant.apache.org

Re: Ivy site

[Nicolas Lalevée <ni...@hibnet.org>]

Le 18 nov. 2010 à 00:05, Maarten Coene a écrit :

> Hi all,
> 
> within a few hours, an updated Ivy site should be online where the general part 
> should fulfill most of the requirements listed here: 
> http://www.apache.org/foundation/marks/pmcs
> 
> I didn't update the documentation belonging to the Ivy releases though, which 
> means that a lot of pages won't follow these requirements. I can regenerate all 
> this historical content as well to make sure the updated headers/footers/logo's 
> are shown. However, this won't change any content on these pages, so they will 
> still use 'Ivy' instead of 'Apache Ivy' for instance. 
> 
> 
> A concrete example:
> http://ant.apache.org/ivy/history/latest-milestone/index.html
> 
> This index.html has been generated from the tagged index.html in SVN:  
> https://svn.apache.org/repos/asf/ant/ivy/core/tags/2.2.0/doc/index.html
> 
> The first sentence is: "Welcome to the official Ivy documentation."
> According to the new requirements, this should be: "Welcome to the official 
> Apache Ivy (TM) documentation."
> 
> So if I want to change this sentence, I have the change the tag. The 
> headers/footers are not a problem, they are regenerated when the site is 
> generated, the problem is the content only.
> How should I deal with this?

For each version there is a tag, but there is also a specific release branch.
Maybe the site should rely on these branches more than on the tags ?

Nicolas


---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
For additional commands, e-mail: dev-help@ant.apache.org

Re: Ivy site

[Stefan Bodewig <bo...@apache.org>]

On 2010-11-18, Maarten Coene wrote:

> within a few hours, an updated Ivy site should be online where the
> general part should fulfill most of the requirements listed here:
> http://www.apache.org/foundation/marks/pmcs

Thank you Maarten, this looks good.

> I didn't update the documentation belonging to the Ivy releases
> though, which means that a lot of pages won't follow these
> requirements. I can regenerate all this historical content as well to
> make sure the updated headers/footers/logo's are shown. However, this
> won't change any content on these pages, so they will still use 'Ivy'
> instead of 'Apache Ivy' for instance.

Personally I'd only bother with the latest release - and ensure future
releases will be fine, of course.  I don't think you need to change all
historical docs in particular since some of the docs predate Ivy's
move to the ASF.

> A concrete example:
> http://ant.apache.org/ivy/history/latest-milestone/index.html

> This index.html has been generated from the tagged index.html in SVN:
> https://svn.apache.org/repos/asf/ant/ivy/core/tags/2.2.0/doc/index.html

Would it be possible to create a branch from this tag and use the branch
for the site?

Stefan

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
For additional commands, e-mail: dev-help@ant.apache.org