Site architecture
Summary
Here we describe how the site content is organized so that you can find it by following the path in the URL.
Note: IMPORTANT: Content below this box is old. Please refer to WPD/Content/Topic_Hierarchy and WPD/Getting_Started for the latest best practices.
Ask us!
If you have a question about how to contribute to webplatform.org, you’ll find us chatting away at irc.freenode.org in the #webplatform chat room. See Help for more information.
Site Structure
The root of the wiki is docs.webplatform.org/wiki/. This is the wiki where all documentation will exist, and it is collaborative.
The structure of the wiki is broken down into technology, characteristic, and article name. For example, the URL for the href attribute in HTML is html/attributes/href.
Article names are case-sensitive (e.g. getAttribute). but the proposal is to use lowercase names for the hierarchy (e.g. html instead of HTML).
Proposed Site Structure
See also Topic Hierarchy.
- concepts
- concepts / accessibility
- concepts / information architecture
- concepts / internet and web
- concepts / one web
- concepts / progressive enhancement
- concepts / programming
- concepts / mobile web
- concepts / responsive design
- concepts / security
- concepts / ux
- concepts / foo
- HTML
- HTML / foo
- HTML / validation
- HTML / quirks mode
- HTML / data-types
- HTML / data-types / foo
- HTML / Elements
- HTML / Elements / foo
- HTML / attributes
- HTML / attributes / foo
- HTML / apis
- HTML / apis / foo
- HTML / apis / methods
- HTML / apis / methods / foo
- HTML / apis / properties
- HTML / apis / properties / foo
- HTML/tutorials (read-only) a list of tutorials categorized as HTML
- CSS
- CSS / foo
- CSS / inheritance
- CSS / cascade
- CSS / vendor prefixes
- CSS / data-types
- CSS / data-types / length
- CSS / data-types / foo
- CSS / properties
- CSS / properties / foo
- CSS / functions
- CSS / functions / “foo”
- CSS / keywords
- CSS / keywords / “foo”
- CSS / selectors
- CSS / selectors / foo
- CSS / atrules
- CSS / atrules / “foo”
- CSS / apis
- CSS / apis / foo
- CSS / apis / methods
- CSS / apis / methods / foo
- CSS / apis / properties
- CSS / apis / properties / foo
- CSS / tutorials (a list of tutorials categorized as CSS)
- SVG
- SVG / foo
- SVG / data-types
- SVG / data-types / foo
- SVG / Elements
- SVG / Elements / foo
- SVG / attributes
- SVG / attributes / foo
- SVG / apis
- SVG / apis / foo
- SVG / apis / methods
- SVG / apis / methods / foo
- SVG / apis / properties
- svg / apis / properties / foo
- SVG / tutorials (a list of tutorials categorized as SVG)
- mathml
- mathml / foo
- mathml / data-types
- mathml / data-types / foo
- mathml / elements
- mathml / elements / foo
- mathml / attributes
- mathml / attributes / foo
- mathml / tutorials (a list of tutorials categorized as MathML)
- xml
- xml / foo
- xml / data-types
- xml / data-types / foo
- xml / elements
- xml / elements / foo
- xml / attributes
- xml / attributes / foo
- xml / tutorials (a list of tutorials categorized as XML)
- aria
- aria / foo
- aria / attributes
- aria / attributes / foo
- aria / tutorials (a list of tutorials categorized as ARIA)
- apis
- apis / foo
- apis / foo / foobar (interface)
- apis / foo / foobar / baz method
- apis / foo / foobar / baz property
- apis / foo / foobar (interface)
- apis / quux (the Quux API has only one interface)
- apis / quux / quux method
- apis / quux / quux property
- apis / foo
- dom
- dom / foo
- dom / apis
- dom / apis / foo
- dom / apis / methods
- dom / apis / methods / foo
- dom / apis / properties
- dom / apis / properties / foo
- dom / tutorials (a list of tutorials categorized as DOM)
- events
- events / foo
- events / apis
- events / apis / methods
- events / apis / methods / foo
- events / apis / properties
- events / apis / properties / foo
- events / apis / methods
- dom / tutorials (a list of tutorials categorized as events)
- js
- js / feature-detection
- js / OOP
- js / apis-general-context
- js / foo
- js / data-types
- js / data-types / string
- js / data-types / number
- js / data-types / foo
- js / syntax
- js / syntax / foo
- js / objects
- js / objects / foo
- js / functions
- js / functions / foo
- js / statements
- js / statements / foo
- js / operators
- js / operators / foo
- js / tutorials (a list of tutorials categorized as Javascript)
- js / libraries
- js / libraries / jQuery
- js / libraries / foo
- glossary
- tutorials (links to tech-specific tutorials)
- tutorials / web standards curriculum
- tutorials / responsive web design
- tutorials / accessibility
- tutorials / foo
- proprietary
- proprietary / microsoft
- proprietary / microsoft / pinned sites
- proprietary / microsoft / silverlight
- proprietary / microsoft / foo
- proprietary / opera
- proprietary / opera / extensions
- proprietary / opera / foo
- proprietary / google
- proprietary / google / NaCl
- proprietary / google / foo
- proprietary / apple
- proprietary / apple / foo
- proprietary / mozilla
- proprietary / mozilla / foo
- proprietary / foo
- proprietary / microsoft
Content Requirements
See also the Content Requirements page.
Page Types
These are types of reference pages we need for the site’s information architecture.
Note: These are basic primitives that need unique templates in MediaWiki; having a unique template allows us to perform queries and aggregations, and supplements the page hierarchy architecture structure as a method of categorization; another way of categorizing them is through MediaWiki categories that can be added to each page. There may be some templates that only reuse the same basic elements as other pages, such as page name, summary, syntax, and example; it is still useful to have unique templates for them for purposes of organization and querying.
- WPD/Architecture/Common Aspects which are included in all reference pages (transclusion?)
- WPD/Architecture/Element Reference
- Examples: elements for HTML, SVG, MathML
- WPD/Architecture/Attribute Reference
- Examples: attributes for HTML, SVG, and MathML elements
- WPD/Architecture/Markup Structure
- Examples: Doctypes, comments, CDATA sections, entities (?)
- WPD/Architecture/JavaScript Statements
- Subcategories: Control structures, declarations
- WPD/Architecture/JavaScript Operator
- WPD/Architecture/Regex metacharacter
- Subcategories: Expressions (character classes, grouping etc), Quantifiers, Anchors, Assertions, Flags
- WPD/Architecture/Object
- WPD/Architecture/Data type
- CSS Property types, HTML and SVG attribute value types
- In JS, every primitive also corresponds to an object. E.g. there are numbers and Number objects. Will they both be described by the same page or different pages?
- WPD/Architecture/Constants
- This might be for constants in APIs, but also might include things like a table of color names, ascii entity codes, etc.
- CSS @rule Reference
- CSS Selector Reference
- Note: Pseudo-classes and pseudo-elements and other selectors will all use the same template but we should have tags to differentiate them.
- CSS Property Reference
- CSS Function Reference
- CSS Keyword Reference
- CSS Media Features
- for media queries, import rules, style declarations
- WPD/Architecture/Event Reference
- WPD/Architecture/Protocol Reference
- WPD/Architecture/Tutorial
- WPD/Architecture/Media_Content
- WPD/Architecture/Glossary
Article Naming Conventions
Suggested Titling/Naming Convention for Article Types (Dave Gash).
See WPD/Manual_Of_Style#Descriptive_Titles Manual Of Style, Descriptive Titles
Notes
- Should attributes in the same language that apply to different elements with different values for each have a different page, or should there be an aggregate page with multiple sections?
Notes
We want aggregated pages, where content from other related pages is transcluded into a single page
- 'Example:’ the page for an interface will contain all the transcluded information from the individual method and property pages
- 'Example:’ the page for the font shorthand property will also contain the pages (or links to) font-family, font-feature-settings, font-kerning, font-language-override, font-size, font-size-adjust, font-stretch, font-style, font-variant, font-variant-ligatures, and font-weight properties
- 'Example:’ the page for an element will contain all the information for each of its attributes, which are each a separate page. (Note: what about the href attribute, which appears on multiple elements… maybe some thing like a sub-form, for context for each element where it appears?)
For CSS property values (and other pages), we want not only a linked data type (e.g. <length>), but also an explanation of what the length means in that context, the range of values, etc. (Some sort of sub-form? see “Multiple-instance templates”)