Re: [Springframework-user] Re: [Springframework-developer] New www.springframework.org site is live!

[Colin S. <col...@ex...>]

Matt Raible wrote:

>
> On May 5, 2005, at 2:45 PM, Colin Sampaleanu wrote:
>
>> The CMS here is Drupal.
>>
>> It's certainly possible to handle historical URLs, and some already  
>> are. Most of the site is handled dynamically by Drupal, but
>>   /dtd
>> and
>>  /buttons
>> is redirected internally (invisibly) by Apache to the new
>>  http://static.springframework.org
>> site meant for completely static content like online documentation. 
>> It  was critical to do this to not break DTD URLs and existing 
>> button  links using the images directly from the Spring website.
>>
>> There is a question of what to do this for however. The old static  
>> structure was somewhat adhoc and simplistic. If you look at your  
>> example
>>    http://www.springframework.org/docs/api/org/springframework/web/ 
>> servlet/mvc/SimpleFormController.html
>> there's no product name (spring base library vs. webflow vs whatever  
>> other lib) in there, and there's no version number. Under the new  
>> structure, this is available as
>>   http://static.springframework.org/spring/docs/1.1.5/api/org/ 
>> springframework/web/servlet/mvc/SimpleFormController.html
>
>
> I can see your point.  However, in Spring Live - whenever I've  
> mentioned a class name, I've linked to it's javadoc - making it easy  
> for readers to look up and see more information about a class.  I did  
> this on a couple while writing and the tech editors and readers liked  
> it so much, I did it for all of them.  I'd hate to have to go back  
> through and change all these links to point to a specific product and  
> version number.
>
> Matt

Ok, for historical purposes, I've internally redirected (i.e. it will be 
invisible to requesters)
   http://www.springframework.org/docs/api/XXXXXXX
to the current production version Javadocs. In the same fashion,
   http://www.springframework.org/docs/reference/XXXXXXX
is redirected to the current production version reference manual.

On the new static site, I have created some symlinks. So you can do
   http://static.springframework.org/spring/docs/1.1.5/api/XXXX
   http://static.springframework.org/spring/docs/1.1.x/api/XXXX
   http://static.springframework.org/spring/docs/current/api/XXXX

and get to the same thing. On this basis, to access the 1.2 RC tree you 
can do
   http://static.springframework.org/spring/docs/1.2RC2/api/XXXX
   http://static.springframework.org/spring/docs/1.2.x/api/XXXX

The same thing for the reference manual.

This means people can refer to a specific version of any release, the 
current version of any point release (1.1.x, etc.), and the current 
(most up to date) production version, period.

Colin

-- 
Colin Sampaleanu
Interface21 Principal Consultant
Spring Training, Consulting and Support - "From the Source"
http://www.springframework.com