test
Start contributing content
Anyone can contribute to the WebPlatform.org wiki. First, read the Editor's Guide to learn how to set up your account, find information about how we work, and get the details about editing content. Then come back here and dig in!
This page provides lists of pages that need your help; these are broken out by task. Scroll down the page to find a task you'd like to perform. In the table for each task, click the link to a page that needs the work.
As you work, do the following:
- Check out the page you're working on so that other editors don't attempt to work on the same page.
- Edit the page, check the box, Checked out (this article is currently being worked on), save the page, then reopen it and resume working.
- Don't forget to uncheck the box when you're done editing the page.
- if you have any questions, just ask the community on IRC or e-mail.
- Refer to Step 5 of the Editor's Guide for information about editing pages.
The tasks are listed by degree of experience and knowledge required. As you move from the basic tasks to more advanced tasks, you'll gain greater expertise, both in using the wiki and in the subject matter. Choose from the following types of tasks:
Basic tasks for new-comers
Start with basic tasks to get your feet wet and learn about the wiki and its workings.
Go to basic tasks
More involved tasks
These require more experience with the wiki, and more technical or subject-matter knowledge.
Go to involved tasks
Advanced tasks
May require knowledge of the wiki templates and forms, and more interaction with the community.
Go to advanced tasks
Basic tasks
Tasks in this category require little technical or subject-matter knowledge, they don't require a lot of time to complete, and yet they are very important to maintaining the readability and integrity of the content.
Edit for spelling & grammar
(11 results)
Pages with the Spelling & grammar flag checked require attention to fix grammar and spelling mistakes. Misspelled words are underlined with dashed red lines in the editing interface. When fixing these, it is often helpful to refer to the artifact's specifications for specialized terms. See Update existing content for more information.
The following criteria are applied:
- Content quality flags: Grammar/Spelling
| Page | Summary |
|---|---|
| css/properties/mask-box-image-outset | The values specify the amount by which the mask box image area extends beyond the border box. If it has four values, they set the outsets on the top, right, bottom and left sides in that order. If the left is missing, it is the same as the right; if the bottom is missing, it is the same as the top; if the right is missing, it is the same as the top. As with ‘mask-box-image-width’, a <number> represents a multiple of the corresponding ‘border-width’. Negative values are not allowed for any of the ‘mask-box-image-outset’ values. |
| css/properties/mask-box-image-repeat | This property specifies how the images for the sides and the middle part of the mask image are scaled and tiled. The first keyword applies to the horizontal sides, the second to the vertical ones. If the second keyword is absent, it is assumed to be the same as the first. |
| css/properties/mask-box-image-slice | This property specifies inward offsets from the top, right, bottom, and left edges of the mask image, dividing it into nine regions: four corners, four edges and a middle. The middle image part is discarded (treated as fully transparent black) unless the ‘fill’ keyword is present. When four values are specified, they set the offsets on the top, right, bottom and left sides in that order. If the left is missing, it is the same as the right; if the bottom is missing, it is the same as the top; if the right is missing, it is the same as the top. |
| css/properties/mask-box-image-source | Specifies an image to be used as mask. If the value is ‘none’ or if the image cannot be displayed (or the property doesn't apply), the content won't get masked. |
| css/properties/mask-clip | Determines the mask painting area, which determines the area that is affected by the mask. The painted content of an element may be resricted to this area. |
| More results | |
Fix broken links
(0 results)
- Fix broken links and misspelled words
Broken links are fairly easy to spot on the wiki, because they display in a bold red color. Fix broken links or check the Broken Links flag so someone else can find the page and fix them. Misspelled words are underlined with dashed red lines in the editing interface. Please fix any misspelled words you find. - Add more useful links
Feel free to add useful, relevant links to external resources to show more examples to illustrate a technique or technology.
The following criteria are applied:
- Content quality flags: Broken Links
Nothing found!
Improve titles
(4 results)
Some titles may not fully describe the article. The article may have been imported without a title or there are other reasons the title needs revisiting. See Titles for more information.
The following criteria are applied:
- High-level issues: Undescriptive Title
| Page | Summary |
|---|---|
| apis/timing-and-performance | |
| apis/websocket/WebSocket | Object for creating and managing a WebSocket connection to a server, as well as for sending and receiving data on the connection. |
| concepts/programming/javascript/functions | Functions are one of the fundamental building blocks in JavaScript. A function is a JavaScript procedure—a set of statements that performs a task or calculates a value. To use a function, you must define it somewhere in the scope from which you wish to call it. |
| css/properties/mask-image | This property sets the mask image(s) or the mask source of an element. Images are drawn with the first specified one on top (closest to the user) and each subsequent image behind the previous one. |
Set topic flags
(2333 results)
Every page should have at least one topic flag, usually more. See Topics and topic clusters so you're clear on how to use these.
The following criteria are applied:
- High-level issues: Needs Topics
| Page | Summary |
|---|---|
| apis/pointerevents | Pointer Events represent events and related interfaces for handling hardware agnostic pointer input from devices like a mouse, pen, or touchscreen. |
| apis/timing-and-performance | |
| apis/timing/methods/cancelAnimationFrame | |
| apis/timing/methods/clearImmediate | |
| apis/timing/methods/msWriteProfilerMark | |
| More results | |
Provide syntax highlighting
(1901 results)
Apply the correct code syntax coloring to code blocks. See Syntax highlighting for details. With HTML code examples, if the <syntaxhighlight> tag is not applied, the code will look broken, so making sure the tag is appied is crucial to the example's readability.
The following criteria are applied:
- Topics: API, CSS, DOM, MathML, SVG
- Content quality flags: Examples Best Practices
| Page | Summary |
|---|---|
| apis/audio-video/audio | |
| apis/audio-video/track | |
| apis/audio-video/video | |
| apis/file api | |
| apis/indexedDB/properties/indexedDB | Provides access to the IndexedDB features supported by the browser and/or device. |
| More results | |
Fill in missing summaries
(439 results)
Every page should include a short summary that provides an overview of the article. Summaries are used in generated overview pages and descriptions in tables (like the tables in this guide). Writing a summary requires just writing a sentence or two in your own words. For source material, refer to the article itself or supporting material like specifications and external references. See Enter helpful article summaries for more information.
The following criteria are applied:
- Content quality flags: Needs Summary
Provide missing flags
(99 results)
Edit the page and check the different High-level issues and Content flags at the top of an article. Flagging pages is critical to help other contributors find tasks to do. You can either start with pages already identified as needing flags, listed below, or simply start in the wiki somewhere, looking for pages that have issues but no flags.
The following criteria are applied:
- High-level issues: Needs Flags
| Page | Summary |
|---|---|
| concepts/web design | The web, in its infancy, was proposed by Tim Berners-Lee as a "WorldWideWeb" designed to create an interconnected digital corpus of documents related to CERN for the benefit of their particle physicists. Early web pages were simple, text-based documents with hyperlinks embedded in them referencing other related texts.
Although conceived as a means of linking scholarly texts in 1989, the Web has evolved dramatically since its initial implementation. The Web is not simply text any longer. It has expanded into something greater: newspapers, community discussion boards, photo galleries, financial management tools, multiplayer gaming. With all the competing content now on the web, how do you make your offering attractive to people and keep them coming back for more? |
| css/cssom/CSSMediaRule/cssRules | Gets a list of rules within a @media block. |
| css/cssom/CSSRule/cssText | Gets or sets a textual representation of a CSS rule. |
| css/cssom/CSSStyleDeclaration/cssText | Gets or sets the textual representation of a CSS style declaration. |
| css/properties/mask-clip | Determines the mask painting area, which determines the area that is affected by the mask. The painted content of an element may be resricted to this area. |
| More results | |
Fill in compatibility tables
(2577 results)
Note: We anticipate automating the population of the compatibility tables in the near future, and we recommend against working on compatibility tables by hand. Instead, use your time to work on the other tasks on this page. This information is included for reference only.
Generally, the missing information in compatibility tables can be verified by comparing other online resources, such as www.caniuse.com or the www.quirksmode.org site. Identify the compatibility of a feature for each browser, and then enter the values in the form. See the Compatibility page to learn more.
The following criteria are applied:
- Content quality flags: Compatibility Incomplete
| Page | Summary |
|---|---|
| /html/elements/output | The HTML <output> element represents the result of a calculation. |
| apis/audio-video/AudioTrack | AudioTrack is an object representing an audio portion of a video element. |
| apis/audio-video/AudioTrack/enabled | Returns true if the given track is active, and false otherwise. Can be set, to change whether the track is enabled or not. If multiple audio tracks are enabled simultaneously, they are mixed. |
| apis/audio-video/AudioTrack/id | Returns the ID of the given track. This is the ID that can be used with a fragment identifier if the format supports the Media Fragments URI syntax, and that can be used with the getTrackById() method. |
| apis/audio-video/AudioTrack/kind | Returns the category the given track falls into. |
| More results | |
Involved tasks
Articles in the lists below have issues for which the resolution may require subject-matter expertise or technical knowledge (fluency in JavaScript, CSS, MediaWiki, etc.).
Edit content for neutrality
(2372 results)
WebPlatform.org aims to provide vendor-neutral documentation. If you find a section that describes a feature as if it only works in a certain browser, or a section of code that could work across all browsers, but won't because it only uses one or two browsers' vendor prefixes, please edit these pages. If you cannot fix the page yourself, check the Not Neutral box under High-level issues so someone else can find and edit it.
The following criteria are applied:
- Content quality flags: Not Neutral
| Page | Summary |
|---|---|
| apis/audio-video/audio | |
| apis/audio-video/track | |
| apis/audio-video/video | |
| apis/file api | |
| apis/indexedDB/properties/indexedDB | Provides access to the IndexedDB features supported by the browser and/or device. |
| More results | |
Fix content that is not semantic
(2378 results)
WebPlatform uses Semantic Media Wiki and Semantic Forms to organize information in a structured way. Sometimes, however, the information is represented on a page in an unstructured field. Often it is as simple as moving content from one text box to another. However, it may be that the extant forms do not provide a way to represent the information semantically, in which case the resolution first requires a new form/template to be added to the wiki. For that case, you would leave the "Data Not Semantic" flag checked and file a bug to request the new form/template.
For example, in the page for the MediaStreamTrack.readyState property, the return value describes three possible enum values with raw text. A SMW form would more properly identify the values as an enum with a table of name, numerator, and description information for each value.
This type of issue is difficult to spot, but it is pervasive throughout the wiki. Basically, any time you see structured information - like an enum - represented in an unstructured way, you should check the Data Not Semantic flag for the page where you find that information.
See also the Implementation Patterns page to learn more about how we use forms and templates to organize and present information.
The following criteria are applied:
- High-level issues: Data Not Semantic
| Page | Summary |
|---|---|
| apis/audio-video/audio | |
| apis/audio-video/track | |
| apis/audio-video/video | |
| apis/file api | |
| apis/indexedDB/properties/indexedDB | Provides access to the IndexedDB features supported by the browser and/or device. |
| More results | |
Review content
The great thing about a wiki is that it's always under review. However, when an article is marked with the Needs Review flag, the author has specifically requested help from the community in verifying the content. Reviewing an article requires a working knowledge of the subject, and often requires the testing of code samples. When you review an article, always check it against the most recent specifications.
API pages that need review
(727 results)
The API pages listed here require a review by a community member familiar with their subject matter and capable of evaluating JavaScript code samples.
The following criteria are applied:
- Topics: API
- High-level issues: Needs Review
| Page | Summary |
|---|---|
| apis/MediaStream/ended | All tracks of the MediaStream object have ended; the MediaStream is said to be finished. |
| apis/appcache | In order to enable users to continue interacting with Web applications and documents even when their network connection is unavailable — for instance, because they are traveling outside of their ISP's coverage area — authors can provide a manifest which lists the files that are needed for the Web application to work offline and which causes the user's browser to keep a copy of the files for use offline. |
| apis/appcache/ApplicationCache | The Application Cache (AppCache) lets web-based applications run offline. Developers can specify resources for the browser to cache, making them available to the application even if no connection can be made to the server. These resources load and work correctly even if users click the refresh button when they are offline. |
| apis/appcache/ApplicationCache/abort | Cancels the application cache download process. This method is intended to be used by Web applications showing their own caching progress UI, in case the user wants to stop the update (e.g., because bandwidth is limited). |
| apis/appcache/ApplicationCache/oncached | The resources listed in the manifest have been downloaded, and the application is now cached. |
| More results | |
CSS pages that need review
(55 results)
The CSS pages listed here require a review by a community member familiar with CSS.
The following criteria are applied:
- Topics: CSS
- High-level issues: Needs Review
| Page | Summary |
|---|---|
| apis/css-regions/NamedFlow | Represents content to flow among various block region elements. The NamedFlow interface allows access to both the content of the flow and the series of regions in which it displays, and helps determine if the content exceeds or falls short of the number of regions necessary to display it. |
| apis/css-regions/NamedFlow/firstEmptyRegionIndex | Returns the integer index of the first empty element within a region chain. Returns -1 if the content fits within the region chain or if it exceeds available space. |
| apis/css-regions/NamedFlow/getContent | Returns a collection of nodes representing the flow's source content. |
| apis/css-regions/NamedFlow/getRegions | Returns the series of regions into which content flows. |
| apis/css-regions/NamedFlow/getRegionsByContent | Returns the series of regions that contain at least part of the supplied target content element. |
| More results | |
Merge duplicates
(21 results)
Where articles are marked as Merge Candidate the article may be a duplicate of another article, or two or more articles may be sufficiently similar in scope to be merged. If you find an article that you believe is a merge candidate, mark the flag and cite the duplicate page in the Editorial notes field.
The following criteria are applied:
- High-level issues: Merge Candidate
| Page | Summary |
|---|---|
| CSS/Selectors/pseudo-classes/:target | |
| apis/audio-video/track | |
| apis/window | The window object is the top level Javascript object in a page, and is the global scope for a browser tab. Global Javascript variables appear in the window object, as well as several important objects such as document. |
| concepts/programming/Core JavaScript Objects | |
| concepts/programming/javascript/core objects | This chapter describes the predefined objects in core JavaScript: Array, Boolean, Date, Function, Math, Number, RegExp, and String. |
| More results | |
Develop code examples
Say it with code. Examples are by far the most important type of content we can produce, and every reference article should have a code example that describes how to use the feature. Presently we're concentrating on CSS properties and JavaScript APIs, so we've listed those types of articles which need examples foremost.
CSS pages that need examples
(119 results)
Develop examples for CSS pages. Our topic types don't specify CSS properties per se, so look for the "css/properties" namespace identifier in the link to the article when concentrating on CSS properties pages.
The following criteria are applied:
- Topics: CSS
- Content quality flags: Examples Needed
| Page | Summary |
|---|---|
| JavaScript animation | Javascript can be used to create animation effects on a web page as simple as highlighting new content in yellow and then fading it back to normal, creating transitions, or moving elements on the page (think popup windows). Creative use of techniques and tools such as common Javascript libraries allows us to create user interfaces that are unobtrusive and responsive to user behavior. We begin by using Javascript's setInterval() function to create our own animations by manipulating DOM elements' CSS properties to create effects. Later, we illustrate the use of code libraries like jQuery to create more complex animations or create simple effects more easily than using by Javascript alone. |
| concepts/general programming | These articles introduce you to computers, computer programming, computer networking, and programming for the Web specifically. |
| css/cssom/CSSRule/cssText | Gets or sets a textual representation of a CSS rule. |
| css/cssom/CSSStyleDeclaration/cssText | Gets or sets the textual representation of a CSS style declaration. |
| css/cssom/CSSStyleDeclaration/getPropertyPriority | Gets the priority of a property in a CSS style declaration. |
| More results | |
API pages that need examples
(694 results)
The JavaScript API pages listed here need code examples.
The following criteria are applied:
- Topics: API
- Content quality flags: Examples Needed
| Page | Summary |
|---|---|
| apis/appcache/ApplicationCache | The Application Cache (AppCache) lets web-based applications run offline. Developers can specify resources for the browser to cache, making them available to the application even if no connection can be made to the server. These resources load and work correctly even if users click the refresh button when they are offline. |
| apis/appcache/ApplicationCache/abort | Cancels the application cache download process. This method is intended to be used by Web applications showing their own caching progress UI, in case the user wants to stop the update (e.g., because bandwidth is limited). |
| apis/appcache/ApplicationCache/oncached | The resources listed in the manifest have been downloaded, and the application is now cached. |
| apis/appcache/ApplicationCache/onchecking | The user agent is checking for an update, or attempting to download the manifest for the first time. This is always the first event in the sequence. |
| apis/appcache/ApplicationCache/ondownloading | The user agent has found an update and is fetching it, or is downloading the resources listed by the manifest for the first time. |
| More results | |
Other articles needing examples
(481 results)
Here are some more articles that need examples.
The following criteria are applied:
- Topics: DOM, DOMEvents, HTML, JavaScript, MathML, SVG
- Content quality flags: Examples Needed
| Page | Summary |
|---|---|
| JavaScript animation | Javascript can be used to create animation effects on a web page as simple as highlighting new content in yellow and then fading it back to normal, creating transitions, or moving elements on the page (think popup windows). Creative use of techniques and tools such as common Javascript libraries allows us to create user interfaces that are unobtrusive and responsive to user behavior. We begin by using Javascript's setInterval() function to create our own animations by manipulating DOM elements' CSS properties to create effects. Later, we illustrate the use of code libraries like jQuery to create more complex animations or create simple effects more easily than using by Javascript alone. |
| apis/internationalization/Intl/Collator | |
| apis/internationalization/Intl/DateTimeFormat | |
| apis/internationalization/Intl/NumberFormat | |
| apis/json/parse | Parse a JSON string to a JavaScript object. |
| More results | |
Complete documentation
(1854 results)
Much of the reference information is incomplete. Usually the work here involves revisiting the specifications or other materials and filling in missing information. Refer to the most recent specifications for the feature as you fill in the pages.
The following criteria are applied:
- Topics: API, CSS, DOM, DOMEvents, HTML, JavaScript, MathML
- High-level issues: Missing Relevant Sections
- Content quality flags: Incomplete
| Page | Summary |
|---|---|
| apis/audio-video/audio | |
| apis/audio-video/track | |
| apis/audio-video/video | |
| apis/file api | |
| apis/indexedDB/properties/indexedDB | Provides access to the IndexedDB features supported by the browser and/or device. |
| More results | |
Clean up unreviewed imports
(2372 results)
Much of the content on WebPlatform.org was imported via an automated process and has not been touched. In many cases, the content of a page is not properly organized within the page templates and forms. The content may be out of date, and it may be duplicative.
The following criteria are applied:
- High-level issues: Unreviewed Import
| Page | Summary |
|---|---|
| apis/audio-video/audio | |
| apis/audio-video/track | |
| apis/audio-video/video | |
| apis/file api | |
| apis/indexedDB/properties/indexedDB | Provides access to the IndexedDB features supported by the browser and/or device. |
| More results | |
Fill out Stubs
(125 results)
A stub is merely a placeholder established with the hope that someone will come along and fill in the page. This is a step beyond filling in missing information (see above), and usually requires starting from scratch. Be sure to refer to the most recent specifications for the feature you're documenting.
The following criteria are applied:
- Topics: API, CSS, DOM, DOMEvents, HTML, JavaScript, MathML
- High-level issues: Stub
| Page | Summary |
|---|---|
| apis/indexeddb/IDBCursor/delete | Returns an IDBRequest object and, in a separate thread, deletes the record at the cursor's position, without changing the cursor's position. Once the record is deleted, the cursor's value is set to null. |
| apis/indexeddb/IDBCursor/source | On getting, returns the IDBObjectStore or IDBIndex that the cursor is iterating. This function never returns null or throws an exception, even if the cursor is currently being iterated, has iterated past its end, or its transaction is not active. |
| apis/indexeddb/IDBDatabase/name | Name of the connected database. |
| apis/indexeddb/IDBIndex/count | Runs the steps for asynchronously executing a request and returns the IDBRequest created by these steps. |
| apis/indexeddb/IDBIndex/get | Runs the steps for asynchronously executing a request and returns the IDBRequest created by these steps. |
| More results | |
Other involved tasks
Herein are some other ideas for contributing to the docs.
- Add screenshots or supporting information
Many articles have broken screenshot links, or include notes that a screenshot is needed. See the steps to Prepare and upload screenshots, or provide examples and supporting information to illustrate techniques. - Split articles
Create pages that convey a single, specific concept by splitting up long pages that contain a wide variety of different content. - Write new articles
If you'd like to author new pages, see the suggestion board to find topics to write. If you are not sure if your topic idea is needed, send a message to the team. If your topic suggestion is approved and you do not have time to write the entire article, it is still worth creating a new page with the beginnings of a new article on it. (This is called a stub page). To get more information about creating new pages, see Step 6 of the Editor's Guide. - Suggest new topics to write
If you have a good idea for an article that could be included but don't have the time or skills to write it yourself, it is still worth putting the idea forward. Send a message that outlines the topic and scope of the article. - Improve internal documentation
If you research the Editor's Guide and you cannot find out how to do something, propose an update to the Editor's Guide to make the process easier for other contributors. - Rewriting CC-BY-SA content for CC-BY use
Content original to the site is licensed under a Creative Commons Attribution License (CC-BY 3.0) for maximum reusability. Some material on the site has been imported from other sources that have made it available under a share-alike license such as CC-BY-SA. If you see articles licensed like this, feel free to rewrite the content. See the list of articles licensed as CC-BY-SA to get started.
Advanced tasks
Tasks in this section are often take longer to complete, require coordination with others in the community, or may require elevated access privileges in the wiki.
Presently we're building out a project management system using The Bug Genie (TBG), which will be the go-to site for all of our larger site-wide projects.
Most wanted
Items from the Most Wanted Tasks page will be listed here once their status in TBG is determined, and the Most Wanted Tasks page will be deprecated in favor of this page and the TBG project management system.
Projects
We run a number of long-term projects for improving the wiki infrastructure and content. See project.webplatform.org] for more information. These projects are described also in the Projects page. More information about projects soon.
Template Corps
A small team of people with the requisite knowledge of SMW forms and templates is tasked with improving these for the wiki. See Template Corps for more information.