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">¶</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">¶</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?
Regards,
Stefan
Received on 2017-12-10 17:00:51 CET