Re: Cleaning up the FAQ

On Fri, Jun 24, 2016 at 11:29 AM, Bert Huijben <bert_at_qqmail.nl> wrote:
>
>
>> -----Original Message-----
>> From: Johan Corveleyn [mailto:jcorvel_at_gmail.com]
>> Sent: vrijdag 24 juni 2016 01:10
>> To: Subversion Development <dev_at_subversion.apache.org>
>> Subject: 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: 日本語,
>> 简体中文</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>
>
> I think we should just generalize this section.
>
> There are DST rule changes around the world at least every year -commonly more often- and I don't think anybody would really check for the US 2007 changes specifically any more.
>
> I just checked the archive for the iana timezone database (https://www.iana.org/time-zones) and we are now on the fifth set of rules released in 2016. There were 6 in 2015, 10 in 2014...
>
> I don't think the 2007 rule change warrants its own article when you don't look at it with US-only-glasses.
>

Agreed. In that case this article doesn't need to be moved to the
"Deprecated FAQ".

Any feedback on the general idea (and implementation) of the Deprecated FAQ?

-- 
Johan