specification.html

---
permalink: /specification
layout: article
title: Solid Specification
breadcrumbs:
- title: "Solid Specification"
---

<div datatype="rdf:HTML" property="description">
  <p>The Solid Specification consists of several <a href="/TR/">Technical Reports</a>, each of which is edited by a <a href="https://github.com/solid/specification/blob/main/README.md#solid-panels">Solid panel</a>.</p>
</div>

<section resource="#contributing_to_the_specification" inlist="" rel="hasPart" class="article-section">
  <h2 id="contributing-to-the-specification" property="name">Contributing to the specification</h2>
  <div datatype="rdf:HTML" property="description">
    <p>Before contributing, please read the <a href="/code_of_conduct">Solid Code of Conduct</a> and the <a href="https://www.w3.org/Consortium/cepc/">W3C Code of Ethics and Professional Conduct</a>. Join the <a href="https://www.w3.org/community/solid/">W3C Solid Community Group</a> before providing substantial contributions. Note that Solid encourages adherence to the W3C's <a href="https://www.w3.org/TR/design-principles/">Web Platform Design Principles</a>, in particular the <a href="https://www.w3.org/TR/design-principles/#priority-of-constituencies">Priority of Constituencies</a>.</p>
    <p>Anyone can contribute by filing an <a href="https://github.com/solid/specification/issues">issue via GitHub</a> or by submitting <a href="https://github.com/solid/specification/pulls">pull requests</a>.</p>  
    <p>Present your proposals via the most relevant meetings and communication channels:</p>
    <ul>
      <li>Submit new <strong><u>User Stories</u></strong> to the <a href="https://github.com/solid/user-stories/">Solid User Stories</a> repository. They are tagged according to the aspects of Solid that are relevant to them, so that specification panels can easily find them for the work items at hand.</li>
      <li>
        <p>Help formulate <strong><u>Use Cases and Requirements</u></strong> (UCR) based on the User Stories for each TR:</p>
        <ul>
          <li><a href="https://solid.github.io/authorization-panel/authorization-ucr/">Authorization UCR</a></li>
          <li><a href="https://solid.github.io/notifications-panel/notifications-ucr.html">Notifications UCR</a></li>
          <li>Upcoming: WebID-Profile UCR (<a href="https://github.com/solid/webid-profile/issues/55">issue</a>, <a href="https://github.com/solid/webid-profile/pull/80">PR</a>)</li>
        </ul>
        <p>All Solid UCRs are reviewed by the Diversity, Equity, and Inclusion Team (<a href="https://github.com/solid/deit/blob/main/meetings/2021-11-09.md#deit-to-review-use-cases-in-specification-development">DEIT</a>).</p>
      </li>
      <li>Join the Solid <a href="https://github.com/solid/specification/blob/main/README.md#solid-panels">Panel Meetings</a> to listen, provide insight or suggest topics for discussion. Meeting schedules, agendas and minutes can be found on the GitHub pages of each panel. Please read the <a href="https://github.com/solid/specification/blob/main/meetings/README.md">guidelines for participation</a>before calling in.</p></li>
    </ul>
    <p>More details on how to contribute can be found <a href="https://github.com/solid/specification/blob/main/CONTRIBUTING.md">on GitHub</a>. All proposals undergo an Editorial review process. For more information on proposal submissions and reviews, see the <a href="https://github.com/solid/process">Solid Process</a>.</p>
  </div>
</section>

<section resource="#tracking_progress" inlist="" rel="hasPart" class="article-section">
  <h2 id="tracking-progress" property="name">Tracking Progress</h2>
  <div datatype="rdf:HTML" property="description">
    <p>Keep up-to-date with specification progress by signing up for the <a href="/newsletter">Solid Newsletter</a>. Minutes of meetings are kept by each <a href="https://github.com/solid/specification/blob/main/README.md#solid-panels">panel</a> to track ongoing discussions.</p>
  </div>
</section>