Create a gist now

Instantly share code, notes, and snippets.

What would you like to do?
WPDS Düsseldorf 2014 - JavaScript Group // http://wpd.mx/dusjs

WPDS Düsseldorf 2014 - JavaScript - Final Result

We worked on the Number Object.

Touched Pages

Missing / Superfluous Pages

Questions / Observations

  • There is no code style guide for examples (indentation, spacing, …), and no hints for naming things.
  • There is no generic "data types" page that offers an overview of what's possible, see MSDN, MDN Values, Variables and Literals and MDN Data Structures.
  • should function signatures go in accordance with ECMA (fractionDigits) or natural language (digits)?

Observation on JavaScript templates:

  • "JavaScript" doesn't exist as a Topic Cluster
  • There is no "Compatibility" section
  • There is no "Related Specifications" section
  • There is no "Topics" section (only "Topic Clusters")
  • There is no dedicated section for "Throws" like "Return Value"

WPDS Düsseldorf - JavaScript Group

General Notes

Annotated ES5 can come in handy to verify things, but http://www.ecma-international.org/ecma-262/5.1/ is the resource you want to link to in the specifications section.

The History tells you if someone has already worked on the page or it is a unreviewed import.

Examples are of utmost importance:

  • Look at RegExp and figure out why a well-placed re.index = 0; might have saved you hours of figuring out why your expression isn't matching anything when either the string is mutated, or it's run twice.
  • How many code style errors can you spot in RegExp/index?
  • What is scriptEngineMajorVersion()?
  • complex examples should be made available on code.webplatform.org and linked to in the in-page example's description

General Questions

  • Is it OK to link to foreign articles explaining concepts in depth? Array is precedent for yes.
  • What's the general code style guide to be used for JS Examples? Idiomatic.js? Should we create a guide page for this?

Number Pages on WebPlatform

References

Questions

  • Should there be a general page on primitive types vs. objects, or should new Number(123).valueOf() === 123 be explained in the constructor?
  • As the constructor is explained in Number, why bother with Number/constructor?

Regular Expression Pages on WebPlatform

References

Questions

  • Have "import flags" been forgotten on the JS content?
  • difference between javascript/regular_expression and javascript/RegExp - merge them?

Error Pages on WebPlatform

References

Questions

  • How do we deal with non-standard properties?

The Tough Nut

URLs are really hard. Just explaining what a function does is not enough. encodeURIComponent should explain the difference between + and %20 for encoding spaces. Where that comes from, why that is. Who uses what? (Hint: it's ugly).

Owner

rodneyrehm commented May 18, 2014

Observation on JavaScript templates:

  • "JavaScript" doesn't exist as a Topic Cluster
  • There is no "Compatibility" section
  • There is no "Related Specifications" section
  • There is no "Topics" section (only "Topic Clusters")
  • There is no dedicated section for "Throws" like "Return Value"

Reading through the Ecmascript docs and when it comes down to Number they actually start with the Number Type as defined in sec8.5 so will add some info on this.

Owner

rodneyrehm commented May 18, 2014

Numbers should explain Two's Complement - or at least hint at it

Noticed JavaScript data types are missing, eg: http://docs.webplatform.org/wiki/javascript/data-types
MSDN has a page here

Hey @rodneyrehm, I would like to write from time to time on ... which part should I choose at the next step?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment