subversion-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Johan Corveleyn <jcor...@gmail.com>
Subject Re: Cleaning up the FAQ
Date Fri, 24 Jun 2016 10:28:04 GMT
On Fri, Jun 24, 2016 at 11:29 AM, Bert Huijben <bert@qqmail.nl> wrote:
>
>
>> -----Original Message-----
>> From: Johan Corveleyn [mailto:jcorvel@gmail.com]
>> Sent: vrijdag 24 juni 2016 01:10
>> To: Subversion Development <dev@subversion.apache.org>
>> Subject: Re: Cleaning up the FAQ
>>
>> On Thu, Jun 23, 2016 at 12:33 AM, Johan Corveleyn <jcorvel@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.ja.html">&#26085;&#26412;&#35486;</a>,
>> <a href="faq.zh.html">&#31616;&#20307;&#20013;&#25991;</a></p>
>> -
>> +<p>These are the questions related to the currently
>> +<a href="/docs/release-notes/#supported-versions">supported versions</a>.
>> +For older questions, see <a href="#deprecated-faq">below</a>.</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

Mime
View raw message