CINXE.COM
The w3c.json file
<!DOCTYPE html> <html lang="en"> <head> <meta charset="utf-8"> <meta name="viewport" content="width=device-width"> <title>The w3c.json file</title> <link rel="stylesheet" href="css/wgio.css"> </head> <body> <header> <h1>The <code>w3c.json</code> file</h1> </header> <nav> <a href="/">Home</a> • <a href="https://github.com/w3c/">Repositories</a> • <a href="https://help.github.com/">GitHub Help</a> </nav> <main> <p> Projects operating under the <code>w3c</code> organisation (or related to W3C even if under other umbrellas) are encouraged to specify a <code>w3c.json</code> file at the root of their repository. The purpose of this file is to provide some metadata about repositories so that they can be processed automatically by a <a href='#tools'>variety of tools</a> layered atop the organisation. They can also help humans figure out who to contact for a given problem. </p> <p> Here is an example: </p> <pre>{ "group": "wg/webrtc" , "contacts": ["dontcallmedom"] , "repo-type": "rec-track" }</pre> <p> The fields that are understood at this point are: </p> <dl> <dt id="group" data-type="number|array<number>|string|array<string>"><code>group</code></dt> <dd> The "/"-separated concatenation of group-type ("wg", "cg", "ig", "bg", "tf", "other") and shortname of the <a href="https://www.w3.org/groups/">group or task force</a> in charge of this repository. If the repository is not linked to any group, do not include that field. If the repository is linked to multiple groups, use an array. <pre>"group": ["wg/css", "other/tag", "tf/i18n-jlreq"]</pre> </dd> <dt id="contacts" data-type="array<string>"><code>contacts</code></dt> <dd> An array of people who are considered points of contact for the repository for administrative requests. They aren't necessarily the primary contributor and they aren't necessarily from the W3C Team. Whatever works for any given repository is acceptable. For integration purposes, please use your <em>GitHub</em> ID. </dd> <dt id="repo-type" data-type="string|array<string>"><code>repo-type</code></dt> <dd> String to identify the type and purpose of the repository, or an array of such strings if the repository holds more than one type of content. The possible values for this field are:<br/><br/> <dl> <dt class="value">rec-track</dt> <dd>W3C Recommendation Track Documents including First Public Working Draft, Working Draft, Candidate Recommendation, Proposed Recommendation and W3C Recommendation</dd> <dt class="value">note</dt> <dd>W3C Note Track including Group Draft Note, Group Note and Statement</dd> <dt class="value">registry</dt> <dd>W3C Registry Track including Draft Registry, Candidate Registry, Candidate Registry Draft, and Registry</dd> <dt class="value">cg-report</dt> <dd>W3C Community Group Report</dd> <dt class="value">tests</dt> <dd>Test suite work</dd> <dt class="value">process</dt> <dd>Work around W3C Process document, charters, policies</dd> <dt class="value">workshop</dt> <dd>Repo to manage W3C workshops</dd> <dt class="value">homepage</dt> <dd>Groups' homepages</dd> <dt class="value">translation</dt> <dd>Repo hosting translation of a spec or other documents</dd> <dt class="value">article</dt> <dd>Non-spec documents</dd> <dt class="value">tool</dt> <dd>Development of tools</dd> <dt class="value">project</dt> <dd>Group-independent projects</dd> <dt class="value">others</dt> <dd>Other purposes</dd> </dl> </dd> <dt id="policy" data-type="string"><code>policy</code></dt> <dd> This is essentially a W3C-internal flag. If set to <code class="value">open</code>, any W3C Team member should feel empowered to help with the management of this given repository. This can be set to <code class="value">restricted</code> to indicate that for whatever reason, it is preferable to let the repository be handled only by team contacts directly associated with it. The default value is <code>open</code>. </dd> <dt id="exposed" data-type="boolean"><code>exposed</code></dt> <dd> This flag indicates if a repository gets exposed in the <a href='https://www.w3.org/groups/'>W3C group pages</a>. By default, all public repositories will get exposed (<code>exposed:true</code>) and all private repositories will not get exposed (<code>exposed:false</code>). </dd> </dl> <h2 id="tools">Tooling</h2> <p> There is a variety of tools using the <code>w3c.json</code> files. </p> <h3>Groups</h3> <p> The tools pages of all of the W3C related groups, such as <a href="https://www.w3.org/groups/cg/wicg/tools/">WICG</a> or <a href="https://www.w3.org/groups/wg/vc/tools/">VC</a> are generated using the <a href="https://w3c.github.io/groups/repositories.json">compiled set of <code>w3c.json</code> files</a>. See also the <a href="https://github.com/w3c/groups/blob/main/README.md">w3c/groups README</a>. </p> </main> <footer> <address><a href="https://github.com/w3c/w3c.github.io/">We are on GitHub</a></address> <p> <a href="https://www.w3.org/"><img src="img/w3c.svg" width="65" height="45" alt="W3C Logo"></a> </p> </footer> </body> </html>