- From: Jen Simmons <jen@jensimmons.com>
- Date: Mon, 2 Dec 2013 12:16:56 -0500
- To: Max Polk <maxpolk@gmail.com>
- Cc: Julee <julee@adobe.com>, Doug Schepers <schepers@w3.org>, Webplatform List <public-webplatform@w3.org>
- Message-ID: <CAB0bRKPGKX19-mkXa8Gvqs5Jz_-sDprAk=a-CK=oeKzw2c9K2g@mail.gmail.com>
Why are we not just making everything lowercase in the URLs? That's what I would expect as a user. Also, no spaces in any URL. Instead of: javascript/JavaScript Reference javascript/Math/Math Constants javascript/Number/Number Constants javascript/RegExp/1 9 Properties I would suggest this: javascript/javascript_reference javascript/math/math_constants javascript/number/number_constants javascript/reg_exp/1_9_properties or: javascript/javascriptreference javascript/math/mathconstants javascript/number/numberconstants javascript/regexp/1-9properties It's much easier to guess a URL if they are all consistent. I would not expect most users to be able to guess which words "should" be capitalized or not. More importantly, a URL like this: javascript/operators/unsigned right shift assignment gets quickly turned into: javascript/operators/unsigned%20right%20shift%20assignment Yuk. No spaces. Prevent %20. Jen Jen Simmons designer, consultant and speaker host of The Web Ahead jensimmons.com 5by5.tv/webahead twitter: jensimmons <http://twitter.com/jensimmons> On Sun, Dec 1, 2013 at 2:19 PM, Max Polk <maxpolk@gmail.com> wrote: > On Mon, Nov 25, 2013 at 1:45 PM, Julee <julee@adobe.com> wrote: > >> Hi, Max & All: >> >> We also have the convention that the URL should be lowercase, except for >> the language elements, which should conform to the spec. >> > > Need suggestions below. > > Page renames per Julee: > > BEFORE --> AFTER > javascript/Objects javascript/objects > javascript/Constants javascript/constants > javascript/Properties javascript/properties > javascript/Functions javascript/functions > javascript/Methods javascript/methods > javascript/Operators javascript/operators > javascript/Operators/* javascript/operators/* (all subpages) > > Not modified, unless someone has a better suggestion: > > javascript/JavaScript Reference "JavaScript Reference" capitalized > javascript/Math/Math Constants "Math Constants" capitalized > javascript/Number/Number Constants (same) > javascript/RegExp/1 9 Properties "Properties" capitalized > > Not modified, unless someone has a better suggestion. The following are > language elements that are ideas and are not named: > > javascript/Regular Expression (note: different than Regex) > javascript/operators/Addition Assignment > javascript/operators/Addition > javascript/operators/Assignment > javascript/operators/Bitwise AND Assignment > javascript/operators/Bitwise AND > javascript/operators/Bitwise Left Shift > javascript/operators/Bitwise NOT > javascript/operators/Bitwise OR Assignment > javascript/operators/Bitwise OR > javascript/operators/Bitwise Right Shift > javascript/operators/Bitwise XOR Assignment > javascript/operators/Bitwise XOR > javascript/operators/Comma > javascript/operators/Comparison > javascript/operators/Compound Assignment > javascript/operators/Conditional Ternary > javascript/operators/delete > javascript/operators/Division Assignment > javascript/operators/Division > javascript/operators/in > javascript/operators/Increment and Decrement > javascript/operators/instanceof > javascript/operators/Left Shift Assignment > javascript/operators/Logical AND > javascript/operators/Logical NOT > javascript/operators/Logical OR > javascript/operators/Modulus Assignment > javascript/operators/Modulus > javascript/operators/Multiplication Assignment > javascript/operators/Multiplication > javascript/operators/new > javascript/operators/Right Shift Assignment > javascript/operators/Subtraction Assignment > javascript/operators/Subtraction > javascript/operators/typeof > javascript/operators/Unsigned Right Shift Assignment > javascript/operators/Unsigned Right Shift > javascript/operators/void > > For all but the first above, the parent javascript/operators is fixed, but > these are multiword page names, where the *lower*-case page names are > JavaScript language elements (delete, in, new, typeof, void) and the > upper-case page names are descriptions of the operator (to differentiate > between language element and non-language element in the *reverse* sense of > using case). Whereas javascript/Math is a Math object, a > javascript/operators/Division is really a "/" which is unusable as a page > name, so a descriptive word "Division" is used instead. > > Perhaps under operators we don't want to lower-case everything like this: > > javascript/operators/subtraction > javascript/operators/typeof > javascript/operators/unsigned right shift assignment > javascript/operators/unsigned right shift > javascript/operators/void > > because the above strategy makes typeof and void (actual operators) > indistinguishable from words used to describe the operators (subtraction > and unsigned right shift). Maybe that doesn't matter though since people > can just read the page. > >
Received on Monday, 2 December 2013 18:05:13 UTC