Re: Cleaning up the FAQ

On Thu, Jun 23, 2016 at 12:33 AM, Johan Corveleyn <jcorvel_at_gmail.com> wrote:
...
> Hm, I think I'll go for stsp's suggestion, to move deprecated
> questions to the bottom, but keep everything on one page.
>
> Something like this:
> -----
> For questions related to deprecated SVN versions, click here (-> #deprecated).
>
>
> TOC (recent)
> FAQ (recent)
>
> === separator / heading / whatever ===
> #deprecated
> TOC (deprecated)
> FAQ (deprecated)
> -----
>
> (that first sentence needs some tweaking)

I'm a bit insecure about changing web pages that are immediately
visible to the world :-), so here below is a quick patch with two
questions moved, to show what I mean (if noone objects, I'll apply
this and further updates tomorrow).

If this is okay, I'd then like to move all BDB-related questions to a
specific sub-section ("BDB questions") under the deprecated faq.

[[[
Index: publish/faq.html
===================================================================
--- publish/faq.html (revision 1750019)
+++ publish/faq.html (working copy)
@@ -18,7 +18,9 @@
 <h1>Apache Subversion FAQ</h1>

 <p>Translations: 日本語,
<a href="faq.zh.html">&#31616;&#20307;&#20013;&#25991;</a></p>
-
+<p>These are the questions related to the currently
+supported versions.
+For older questions, see below.</p>
 <div class="h2"><!-- no 'id' or 'title' attribute for TOC -->
 <h2>Table of Contents</h2>

@@ -57,8 +59,6 @@
     get more information?</a></li>
 <li><a href="#moderation">Why isn't my post showing up on the mailing
     list?</a></li>
-<li><a href="#dst-2007">How is Subversion affected by the 2007 changes
- in Daylight Savings Time (DST)?</a></li>
 </ul>

 <h4>How-to:</h4>
@@ -178,9 +178,6 @@
     operations to a Subversion repository over a network.</a></li>
 <li><a href="#vs-asp-net">Microsoft Visual Studio 2002 and 2003 seems to have
     a problem with the ".svn" directory name. What should I do?</a></li>
-<li><a href="#windows-xp-server">Under Windows XP, the Subversion
- server sometimes seems to send out corrupted data. Can this really be
- happening?</a></li>
 <li><a href="#net-trace">What is the best method of doing a network
     trace of the conversation between a Subversion client and server?</a></li>
 <li><a href="#revert">Why does the <tt>svn revert</tt> require an
@@ -733,37 +730,8 @@

 </div>

-<div class="h3" id="dst-2007">
-<h3>How is Subversion affected by the 2007 changes in Daylight
Savings Time (DST)?
- <a class="sectionlink" href="#dst-2007"
- title="Link to this section">&para;</a>
-</h3>
-
-<p>In August 2005 the US Congress passed the Energy Policy Act, which
-changes the dates of both the start and end of daylight saving time
-(DST). When this law went into effect in 2007, DST started three
-weeks earlier (2:00 A.M. on the second Sunday in March) and
-ended one week later (2:00 A.M. on the first Sunday in November)
-than what had traditionally occurred. For more information see:
-<a href="http://webexhibits.org/daylightsaving/b.html">
-http://webexhibits.org/daylightsaving/b.html</a></p>
-
-<p>These changes to DST do not require any special changes or fixes to
-the Subversion code. Subversion primarily uses dates/times to record
-when changes have been committed to the repository. This code runs
-on the server and gets the current date/time from the operating system
-and converts it to UTC using routines provided by the operating system.
-The Subversion client receives these dates from the server and converts
-them to the local time zone for display using routines provided by
-the client operating system. As such, you should only need to install
-the patches provided for your operating system and really you should
-only need to make sure the time on the server is properly adjusted
-for DST.</p>
-
 </div>

-</div>
-
 <div class="h2" id="how-to">
 <h2>How-to:
   <a class="sectionlink" href="#how-to"
@@ -2996,25 +2964,6 @@

-<div class="h3" id="windows-xp-server">
-<h3>Under Windows XP, the Subversion server
- sometimes seems to send out corrupted data. Can this really
- be happening?
- <a class="sectionlink" href="#windows-xp-server"
- title="Link to this section">&para;</a>
-</h3>
-
-<p>You need to install Window XP Service Pack 1. You can get all
-sorts of information about that Service Pack here:</p>
-
- <ul><li>
- <a href="http://support.microsoft.com/default.aspx?scid=kb;EN-US;q317949"
- >http://support.microsoft.com/default.aspx?scid=kb;EN-US;q317949</a>
- </li></ul>
-
-</div>
-
-
 <div class="h3" id="net-trace">
 <h3>What is the best method of doing a network
     trace of the conversation between a Subversion client and
@@ -4680,6 +4629,97 @@

 </div>

+<hr/>
+
+<div class="h1" id="deprecated-faq">
+<h1>Deprecated FAQ</h1>
+
+<div class="h2"><!-- no 'id' or 'title' attribute for TOC -->
+<h2>Table of Contents</h2>
+<h4>General questions:</h4>
+<ul>
+<li><a href="#dst-2007">How is Subversion affected by the 2007 changes
+ in Daylight Savings Time (DST)?</a></li>
+</ul>
+
+<h4>Troubleshooting:</h4>
+<ul>
+<li><a href="#windows-xp-server">Under Windows XP, the Subversion
+ server sometimes seems to send out corrupted data. Can this really be
+ happening?</a></li>
+</ul>
 </div>
+
+<hr/>
+
+<div class="h2" id="deprecated-general-questions">
+<h2>General questions (deprecated):
+ <a class="sectionlink" href="#deprecated-general-questions"
+ title="Link to this section">&para;</a>
+</h2>
+
+<div class="h3" id="dst-2007">
+<h3>How is Subversion affected by the 2007 changes in Daylight
Savings Time (DST)?
+ <a class="sectionlink" href="#dst-2007"
+ title="Link to this section">&para;</a>
+</h3>
+
+<p>In August 2005 the US Congress passed the Energy Policy Act, which
+changes the dates of both the start and end of daylight saving time
+(DST). When this law went into effect in 2007, DST started three
+weeks earlier (2:00 A.M. on the second Sunday in March) and
+ended one week later (2:00 A.M. on the first Sunday in November)
+than what had traditionally occurred. For more information see:
+<a href="http://webexhibits.org/daylightsaving/b.html">
+http://webexhibits.org/daylightsaving/b.html</a></p>
+
+<p>These changes to DST do not require any special changes or fixes to
+the Subversion code. Subversion primarily uses dates/times to record
+when changes have been committed to the repository. This code runs
+on the server and gets the current date/time from the operating system
+and converts it to UTC using routines provided by the operating system.
+The Subversion client receives these dates from the server and converts
+them to the local time zone for display using routines provided by
+the client operating system. As such, you should only need to install
+the patches provided for your operating system and really you should
+only need to make sure the time on the server is properly adjusted
+for DST.</p>
+
+</div>
+
+
+</div>
+
+
+<div class="h2" id="deprecated-troubleshooting">
+<h2>Troubleshooting (deprecated):
+ <a class="sectionlink" href="#deprecated-troubleshooting"
+ title="Link to this section">&para;</a>
+</h2>
+
+<div class="h3" id="windows-xp-server">
+<h3>Under Windows XP, the Subversion server
+ sometimes seems to send out corrupted data. Can this really
+ be happening?
+ <a class="sectionlink" href="#windows-xp-server"
+ title="Link to this section">&para;</a>
+</h3>
+
+<p>You need to install Window XP Service Pack 1. You can get all
+sorts of information about that Service Pack here:</p>
+
+ <ul><li>
+ <a href="http://support.microsoft.com/default.aspx?scid=kb;EN-US;q317949"
+ >http://support.microsoft.com/default.aspx?scid=kb;EN-US;q317949</a>
+ </li></ul>
+
+</div>
+
+
+</div>
+
+</div>
+
+</div>
 </body>
 </html>

]]]

-- 
Johan