Re[2]: how to redirect our website changes

[Ferdinand Soethe <sa...@soethe.net>]

Dave Brondsema wrote:

DB> Did you see our (long) earlier thread? 
DB> http://marc.theaimsgroup.com/?t=109937596400001&r=1&w=2

I did read through that but I might have missed a byte or two along
the way ...

DB> Are you questioning the source structure we have, or the final output?

My proposal was about presentation at the website (final output),
maintaining the docs with the source is fine by me. Plus - so much I
understood from reading that thread - there are a lot of issues like sv
concerned on the source end that I'm only beginning to grasp.

As far as presentation is concerned, I suggested the tabs-solution
because it seemed to solve a lot of issues raised in your discussion
about linking and how to tell the user that this and that belongs to
version x.

With separate tabs for each version, Google would not be a problem as
the url is preserved and the user will automatically get the version
label at the top of the page.

--
Ferdinand Soethe

Here, I dug out the original posting.

> How about maintaining version-related docs as separate subtabs on the
> documentation tab (named "Release 0.5", "Release 0.6" and so on).
> 
> That way users have easy access to the version they are currently
> using but optionally also access versions that are not yet released.
> 
> Google would be OK since the links remain the same, but when opening a page
> in version "Release 0.5", I'd immediately see that there are other
> versions (tabs) to look at.
> 
> And, as far as I can tell, this would also allow us to do away with
> the two branches of documentation and the need to amalgamate them for
> each release as the versioned documentation could simply be managed as
> different subdirectories of the main site.

Re: how to redirect our website changes

[Dave Brondsema <da...@brondsema.net>]

Nicola Ken Barozzi wrote:
> Ferdinand Soethe wrote:
> 
>>
>> Dave Brondsema wrote:
>>
>> DB> Did you see our (long) earlier thread? DB> 
>> http://marc.theaimsgroup.com/?t=109937596400001&r=1&w=2
>>
>> I did read through that but I might have missed a byte or two along
>> the way ...
>>
>> DB> Are you questioning the source structure we have, or the final 
>> output?
>>
>> My proposal was about presentation at the website (final output),
>> maintaining the docs with the source is fine by me. Plus - so much I
>> understood from reading that thread - there are a lot of issues like sv
>> concerned on the source end that I'm only beginning to grasp.
>>
>> As far as presentation is concerned, I suggested the tabs-solution
>> because it seemed to solve a lot of issues raised in your discussion
>> about linking and how to tell the user that this and that belongs to
>> version x.
>>
>> With separate tabs for each version, Google would not be a problem as
>> the url is preserved and the user will automatically get the version
>> label at the top of the page.
> 
> 
> Hmmm...
> 
> Beside all the talks already done, I don't know why but this proposal is 
> still intriguing.
> 
> Other opinions?
> 

All I see is a proposal to have the links to the 0.6 and dev versions be 
  on tabs instead of on the left menu.  Not a major change, but a very 
good one nonetheless.

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

Re: how to redirect our website changes

[Nicola Ken Barozzi <ni...@apache.org>]

Ferdinand Soethe wrote:
> 
> Dave Brondsema wrote:
> 
> DB> Did you see our (long) earlier thread? 
> DB> http://marc.theaimsgroup.com/?t=109937596400001&r=1&w=2
> 
> I did read through that but I might have missed a byte or two along
> the way ...
> 
> DB> Are you questioning the source structure we have, or the final output?
> 
> My proposal was about presentation at the website (final output),
> maintaining the docs with the source is fine by me. Plus - so much I
> understood from reading that thread - there are a lot of issues like sv
> concerned on the source end that I'm only beginning to grasp.
> 
> As far as presentation is concerned, I suggested the tabs-solution
> because it seemed to solve a lot of issues raised in your discussion
> about linking and how to tell the user that this and that belongs to
> version x.
> 
> With separate tabs for each version, Google would not be a problem as
> the url is preserved and the user will automatically get the version
> label at the top of the page.

Hmmm...

Beside all the talks already done, I don't know why but this proposal is 
still intriguing.

Other opinions?

-- 
Nicola Ken Barozzi                   nicolaken@apache.org
             - verba volant, scripta manent -
    (discussions get forgotten, just code remains)
---------------------------------------------------------------------