Ticket #1662 (closed defect: fixed)

Opened 23 months ago

Last modified 15 months ago

JS Style Guide

Reported by: skinner Owned by: pottedmeat
Priority: lowest Milestone: 0.9
Component: Documentation Version: 0.3
Severity: trivial Keywords:
Cc:

Description

On the Dojo coding style guide web page, in the "Quick Reference" section, some of the examples in "Convention" column are confusing:

http://dojotoolkit.org/js_style_guide.html#quick-reference

The style guide uses the words "lower" and "upper" in the capitalization examples. The page includes these examples:

lower
UpperLower
lowerUpper
UPPER_LOWER
_lowerUpper
_upperLower

That seems confusing, since lower sometimes appears capitalized ("Lower" or "LOWER") and upper isn't always capitalized.

Would it be better to just use "foo" and "bar" in the examples instead? Like this:

foo
FooBar
fooBar
FOO_BAR
_fooBar

Or, here's another alternative:

lowercase
CapWords or CamelCase
mixedCase
UPPER_CASE
_mixedCase

The Python style guide uses "mixedCase", "CapitalizedWords?", "lowercase", and "UPPER_CASE_WITH_UNDERSCORES". See http://www.python.org/dev/peps/pep-0008/

Change History

Changed 22 months ago by neil

  • owner changed from neil to pottedmeat

Changed 15 months ago by alex

brian, this looks reasonable. You should have editing perms on the new site. Feel free to make the changes and close. If you don't have editing perms, just ping dmachi or tk.

Changed 15 months ago by skinner

  • status changed from new to closed
  • resolution set to fixed
Note: See TracTickets for help on using tickets.