[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: Thu, 14 Dec 2017 00:12:52 +0100

On 10/12/2017 17:23, Stefan wrote:
> 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
>
>
1.6 docu restored in r1818079 and linked in r1818081.

Regards,
Stefan
Received on 2017-12-14 00:13:00 CET

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