[Mesa-dev] [PATCH 00/11] docs: html cleanup

[Andreas Boll]

2012/6/11 Brian Paul <brianp at vmware.com>:
> On 06/10/2012 04:57 AM, Andreas Boll wrote:
>>
>> Hi,
>>
>> the following patch series is the first part of cleaning up docs/.
>>
>> Please review and commit.
>

Please commit/push. I don't have commit access.

>
> I'm not an HTML expert but these look ok to me.  Can you commit/push or
> should I?
>
>
> Q: are lower-case html tags recommended or the usual convention or just your
> personal preference?  Just wondering.
>

Lower-case is recommended, because it's more future-proof wrt. XHTML
where lower-case tags are required.
I think nowadays it's the usual convention.

You should either use upper- or lower-case tags to be consistent.
So I'm tending to write lower-case only
and it's definitly less use of the shift key ;)

>
>>
>> The next steps are:
>> - finish html cleanup (more well-formed html)
>>     Tools I'm using:
>>     * http://validator.w3.org/
>>     * http://tidy.sourceforge.net/
>> - update docs content
>> - drop obsolete docs
>
>
> OK.
>
>
>
>>
>> @ release manager
>> Is there a script for converting the git shortlog into html in
>> relnotes-*.html or are they converted by hand?
>> The reason I'm asking is that not all html special chars are correctly
>> escaped and the changes are not well-formed.
>
>
> I'm not sure how Ian's been doing that.  If any sort of git/sh script is
> used, it should probably be checked into the tree or documented with the
> rest of the new-release instructions.
>
> Ian?
>
> -Brian