[svn.haxx.se] · SVN Dev · SVN Users · SVN Org · TSVN Dev · TSVN Users · Subclipse Dev · Subclipse Users · this month's index

Re: svn commit: r1817718 - /subversion/site/staging/docs/index.html / Reinstate 1.6 API docu

From: Stefan <luke1410_at_posteo.de>
Date: Sun, 10 Dec 2017 17:23:53 +0100

On 10/12/2017 17:11, Branko ─îibej wrote:
> On 10.12.2017 17:00, Stefan wrote:
>> On 10/12/2017 16:54, luke1410_at_apache.org wrote:
>>> Author: luke1410
>>> Date: Sun Dec 10 15:54:23 2017
>>> New Revision: 1817718
>>>
>>> URL: http://svn.apache.org/viewvc?rev=1817718&view=rev
>>> Log:
>>> * site/staging/docs/index.html: add a new section for unsupported versions and
>>> move the 1.7 links to that section.
>>>
>>> Modified:
>>> subversion/site/staging/docs/index.html
>>>
>>> Modified: subversion/site/staging/docs/index.html
>>> URL: http://svn.apache.org/viewvc/subversion/site/staging/docs/index.html?rev=1817718&r1=1817717&r2=1817718&view=diff
>>> ==============================================================================
>>> --- subversion/site/staging/docs/index.html (original)
>>> +++ subversion/site/staging/docs/index.html Sun Dec 10 15:54:23 2017
>>> @@ -135,19 +135,6 @@
>>>
>>> </div> <!-- #release-1.8 -->
>>>
>>> -<div class="h3" id="release-1.7">
>>> -<h3>Subversion 1.7
>>> -<a class="sectionlink" href="#release-1.7"
>>> - title="Link to this section">&para;</a>
>>> -</h3>
>>> -
>>> -<ul>
>>> - <li>C API</li>
>>> - <li>JavaHL</li>
>>> -</ul>
>>> -
>>> -</div> <!-- #release-1.7 -->
>>> -
>>> <div class="h3" id="next-release">
>>> <h3>Unreleased (1.10-dev)
>>> <a class="sectionlink" href="#next-release"
>>> @@ -175,6 +162,23 @@
>>>
>>> </div> <!-- #latest-release -->
>>>
>>> +<div id="release-1.7"></div>
>>> +<div class="h3" id="unsupported-releases">
>>> +<h3>Archived releses
>>> + <a class="sectionlink" href="#unsupported-releases"
>>> + title="Link to this section">&para;</a>
>>> +</h3>
>>> +
>>> +<p>The following Subversion versions have reached their end of life. We still
>>> + provide the old documentation for archive/historical purposes.</p>
>>> +
>>> +<ul>
>>> + <li>Subversion 1.7 - C API</li>
>>> + <li>Subversion 1.7 - JavaHL</li>
>>> +</ul>
>>> +
>>> +</div> <!-- #unsupported-releases -->
>>> +
>>> </div> <!-- #api -->
>>>
>>> </div> <!-- #site-content -->
>>>
>> Based on the discussion with brane on IRC, I'd like to propose this
>> change to our API documentation and in principle add a new
>> unsupported-releases section where upon each release we move the old API
>> documentation of the then unsupported oldest release to.
>>
>> In addition, I'd like to reinstate the old 1.6 docu and add links to
>> these in this new section. The 1.6 docu was removed in r1696552 and now
>> results in old links to the 1.6 API docu no longer working (one example
>> being a link from the 1.6-release notes). Also I think it'd be quite
>> useful to keep the API documentation for unsupported versions still
>> laying around (it should not cause any significant resources keeping
>> them available, IMO).
>>
>> Note that I'd reinstate the old 1.6 docus directly on publish (rather
>> than on staging) since this would be easier to do (i.e. reverting the
>> corresponding changes from r1696552 which obviously were done on publish).
>>
>> Any objections and/or better ideas?
>
>
> Go ahead, as long as it's perfectly clear that the older releases are
> no longer supported. Your change on the staging site looks OK, except
> that:
>
> * "Archived releses" is not English :p
> * I suggest "Unsupported versions" instead
>
>
Right. And corrected (with two successive commits) - it's "Unsupported
versions" now.

Regards,
Stefan
Received on 2017-12-10 17:23:59 CET

This is an archived mail posted to the Subversion Dev mailing list.