W3C home > Mailing lists > Public > public-webplatform@w3.org > July 2013

Page naming for MSDN JS import

From: Max Polk <maxpolk@gmail.com>
Date: Tue, 2 Jul 2013 13:50:02 -0400
Message-ID: <CADPfvJthPDgg6YFPG6knu0kUuJA6sez5ycgQix-QwMOXcWF1kg@mail.gmail.com>
To: Webplatform List <public-webplatform@w3.org>
This is the page naming plan for the MSDN JS imported web pages.

The converted wiki pages are ready for upload.  This plan describes
how they should be named.

Currently, the top-level hierarchy is:
* Objects
* Constants
* Properties
* Functions
* Methods
* Operators
* Statements
* Directives
* Errors
* Reserved Words
* Future Reserved Words

Within each hierarchy are kinds of each, like kinds of Objects or
kinds of Statements.

These pages listed below don't requre much discussion.  They can be
organized into subpages or incorporated into some subpage easily:

* "Directives" has a single directive subpage "use strict" which
should not be used.
* "Errors" has two subpages: "Run time" and "Syntax".
* "Reserved Words" is a single page that lists words that are already used.
* "Future Reserved Words" is a single page that lists words that might be used.

These pages with all their subpages are the main area of discussion.

* Objects
* Operators
* Statements

Each of these is described below.

Objects
----
If JavaScript had classes, the Objects hierarchy would represent it.
Instead, JavaScript only has notable Objects used mostly to create new
instances, such as creating a new Array.  Special objects like
"arguments" exist automatically inside a function.  Other special
objects are Function, Global, Object.

Subpages for the Array object, for example, describe each property,
function, method, or constant the Array object has:

* Array has three properties: constructor, length, and prototype.
* Array has one function: Array.isArray.
* Array has many methods: concat, every, filter, forEach, indexOf,
join, lastIndexOf, map,
pop, push, reduce, reduceRight, reverse, shift, slice, some, sort,
splice, toString,
unshift, and valueOf.
* Math has a constant Math.E.

Because of this, the current page naming plan is to call the Array
Object's constructor property: "Objects/Array/constructor Property".

To list what we are talking about, the list of all notable Objects are:

* ActiveXObject
* Array
* ArrayBuffer
* arguments
* Boolean
* DataView
* Date
* Debug
* Enumerator
* Error
* Float32Array
* Float64Array
* Function
* Global
* Int8Array
* Int16Array
* Int32Array
* JSON
* Math
* Number
* Object
* RegExp
* Regular Expression
* String
* Uint8Array
* Uint16Array
* Uint32Array
* VBArray
* WinRTError

Operators have their own page and subpages as well.  The full list of pages are:

* Addition Assignment
* Addition
* Assignment
* Bitwise AND Assignment
* Bitwise AND
* Bitwise Left Shift
* Bitwise NOT
* Bitwise OR Assignment
* Bitwise OR
* Bitwise Right Shift
* Bitwise XOR Assignment
* Bitwise XOR
* Comma
* Comparison
* Compound Assignment
* Conditional Ternary
* delete
* Division Assignment
* Division
* in
* Increment and Decrement
* instanceof
* Left Shift Assignment
* Logical AND
* Logical NOT
* Logical OR
* Modulus Assignment
* Modulus
* Multiplication Assignment
* Multiplication
* new
* Right Shift Assignment
* Subtraction Assignment
* Subtraction
* typeof
* Unsigned Right Shift Assignment
* Unsigned Right Shift
* void

Statements each have their own page:

* break
* cc on
* Comment
* continue
* debugger
* do while
* for
* for in
* function
* if
* if else
* Labeled
* return
* set
* switch
* this
* throw
* try catch finally
* var
* while
* with

Now that we have full disclosure of what exists, discussion can begin
aiming at desired format of the page and subpage names.
Received on Tuesday, 2 July 2013 17:50:29 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 21:20:52 UTC