subversion-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Stefan Hett <ste...@egosoft.com>
Subject Re: [PATCH] clean up release notes - pass 3
Date Wed, 01 Jun 2016 10:37:08 GMT
On 6/1/2016 9:47 AM, Stefan Sperling wrote:
> On Mon, May 16, 2016 at 03:44:58PM +0200, Stefan wrote:
>>    (issues): rename section id so it doesn't start with a number
> Is breaking section links like the one below worth it?
>
> It's not going to be a big problem for people to locate the right
> section on the page even if this link changes. But on the other hand,
> it's not a big problem if this page isn't 100% XHTML compliant, is it?
I suggested the patch under the (wrong) assumption that the id starting 
with a number would be invalid in HTML 5 as well. However, I just 
learned that this is valid in HTML 5. It's invalid in HTML 4.01 (or 
lower) as well as in XHTML though. So that sheds a different light on 
this. [1]

I'd still suggest to change that though mainly with the argument that 
browsers (and tools) which rely on the standard more closely and which 
do not support (and also do not fall back to) the HTML 5 style would not 
work at all with that link. I also think it's quite unlikely that there 
are many (if any) direct links out there which would break. So with the 
change we are actually resolving problems for more standard compliant 
and also for older browsers working on that page.

>> @@ -2463,9 +2460,9 @@
>>   <p>There are some known issues in the Subversion 1.8 releases.  These
>>   may be fixed in later 1.8.x releases.</p>
>>   
>> -<div class="h3" id="411-length-required">
>> +<div class="h3" id="length-required-411">
>>   <h3>1.8.0 and chunked Transfer-Encoding
>> -  <a class="sectionlink" href="#411-length-required"
>> +  <a class="sectionlink" href="#length-required-411"
>>       title="Link to this section">&para;</a>
>>   </h3>
>>   
>> @@ -2529,7 +2526,7 @@
>>   href="http://mail-archives.apache.org/mod_mbox/subversion-dev/201307.mbox/%3cCADkdwvQUaWaC5=AvwsthjSQWcn48tKHVfWoVCUHjLT=Abu13YA@mail.gmail.com>">this
dev@ list post</a> for an example.</p>
>>   
>>   
>> -</div>  <!-- 411-length-required -->
>> +</div>  <!-- length-required-411 -->
>>   
>>   <div class="h3" id="mod_dav_svn-fsmap">
>>   <h3>mod_dav_svn Maps Requests to Local Filesystem
>>
[1] http://www.w3schools.com/tags/att_global_id.asp


-- 
Regards,
Stefan Hett


Mime
View raw message