Re: [Accessibility Planning Roadmap Input : Assess the current situation]

Thanks, Shawn!  I'm just seeing this -- after writing my blog post.  Funny
thing your not using a "dedicated  whittler" for your examples.  ;-)

I'm with you 100% --  leave it up to editor's discretion.  If anyone wants
me to help with this, just let me know.  Otherwise, I won't bug you all.  I
care about this stuff, but only in a very shallow way.

AB







On Wed, Dec 2, 2015 at 7:47 AM, Shawn Henry <shawn@w3.org> wrote:

> On 12/1/2015 8:09 PM, Anna Belle Leiserson wrote:
>
>> I'm on this page
>> http://w3c.github.io/wai-dynamic-planning/initiate/review_the_situation.html
>> and I am noticing a pattern of using capital letters to start bullets that
>> are part of one long sentence.  I suggested changing this on the previous
>> page in a pull request (
>> http://w3c.github.io/wai-dynamic-planning/initiate/learn_the_basics.html)
>> that involved some other things.  I didn't want to make this second one a
>> pull request though, since there aren't other issues.   I won't mark it on
>> other pages either, though I do think lowercase is less grammatically
>> incorrect.  There's a whole craziness about how to phrase the sentence
>> before the colon which we aren't doing, and IMO is AOK to ignore.
>>
>
> Thanks for bringing this up, Anna Belle! I apprecaite that you're
> commenting on such issues.
>
> For capitalization, I looked through lots of our pages, and see that we do
> it both ways, e.g.,
> * <http://www.w3.org/WAI/intro/people-use-web/principles> - caps
> * <http://www.w3.org/WAI/bcase/soc> - lowercase
> * <http://www.w3.org/WAI/users/inaccessible - both
> * <http://www.w3.org/WAI/users/involving> - both
> * <http://www.w3.org/WAI/older-users/> - both
>
> I think it depends on the type of info. I propose that we leave it up to
> editor's discretion based on the type of information. I put my suggestion
> in the style guide. I don't feel strongly about this and am happy for
> additional discussion and am fine with a different decision. (although I
> think it's not a priority to change existing documents)
>
> Punctuation: The punctuation also caught my eye. To be less formal, we
> have not been using punctuation in such cases. I added that to the style
> guide.
>
> Spacing: And a related issue: it bugs me to have space before lists like
> these! We get rid of them in many documents, e.g., <
> http://www.w3.org/WAI/users/inaccessible>. So I added that to the style
> guide as well, as optional.
>
> Style guide: I put all of these in a new section on Lists:
> <https://www.w3.org/WAI/EO/wiki/Style#Lists>
> And added a note to the Punctuation and Capitalization sections pointing
> to it.
>
> Feel free to tweak. (I didn't put much thought into the wording of the
> examples.)
>
> Best,
> ~Shawn
>
>
>