Skip to content

Commit 087f23f

Browse files
feat: expand section on contributing to the spec (#795)
Signed-off-by: Wouter Termont <woutermont@gmail.com> Co-authored-by: Timea <4144203+timea-solid@users.noreply.github.com>
1 parent 4dabce5 commit 087f23f

1 file changed

Lines changed: 43 additions & 15 deletions

File tree

pages/specification.md

Lines changed: 43 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -8,36 +8,64 @@ redirect_from:
88

99
# Specification
1010

11-
To read the current specification, see [Solid Specification](https://solidproject.org/TR/).
12-
13-
## Contribute
11+
The Solid Specification consists of several [Technical Reports](https://solidproject.org/TR/), each of which is edited by a
12+
[Solid panel](https://github.com/solid/specification/blob/main/README.md#solid-panels).
1413

14+
## Contributing to the specification
1515

1616
<div class="message is-info">
1717
<p class="message-body">
1818
Before contributing, please read the
19-
<a href="https://github.com/solid/process/blob/master/code-of-conduct.md">Code of Conduct</a>
20-
and <a href="https://www.w3.org/community/solid/"> join the W3C Solid Community Group</a>.
19+
<a href="https://github.com/solid/process/blob/master/code-of-conduct.md">Solid Code of Conduct</a>
20+
and the <a href="https://www.w3.org/Consortium/cepc/"
21+
>W3C Code of Ethics and Professional Conduct</a>.
22+
Join the <a href="https://www.w3.org/community/solid/">W3C Solid Community Group</a>
23+
before providing substantial contributions.
24+
Note that Solid encourages adherence to the W3C's
25+
<a href="https://www.w3.org/TR/design-principles/">Web Platform Design Principles</a>,
26+
in particular the <a href="https://www.w3.org/TR/design-principles/#priority-of-constituencies">Priority of Constituencies</a>.
2127
</p>
2228
</div>
2329

2430
Anyone can contribute by filing an [issue via GitHub](https://github.com/solid/specification/issues)
2531
or by submitting [pull requests](https://github.com/solid/specification/pulls).
2632

27-
For new proposals, present your proposals at the relevant meetings
28-
and communication channels, which include the following weekly recurring meetings:
33+
Present your proposals via the most relevant meetings
34+
and communication channels:
35+
36+
- Submit new **<u>User Stories</u>** to
37+
the [Solid User Stories](https://github.com/solid/user-stories/)
38+
repository. They are tagged according to the aspects of Solid
39+
that are relevant to them, so that specification panels can easily
40+
find them for the work items at hand.
41+
42+
- Help formulate **<u>Use Cases and Requirements</u>** (UCR) based on the User Stories for each TR:
43+
44+
* [Authorization UCR](https://solid.github.io/authorization-panel/authorization-ucr/)
45+
* [Notifications UCR](https://solid.github.io/notifications-panel/notifications-ucr.html)
46+
* Upcoming: WebID-Profile UCR ([issue](https://github.com/solid/webid-profile/issues/55),
47+
[PR](https://github.com/solid/webid-profile/pull/80))
2948

30-
| Panel | When | Meeting Link |
31-
| ----- |------|--------------|
32-
| [Authentication Panel](https://www.w3.org/community/solid/wiki/Authentication_Panel) | Mondays at 16:00 Central European / 10:00 Eastern | [Meeting](https://meet.jit.si/solid-authentication) |
33-
| [Interoperability Panel](https://www.w3.org/community/solid/wiki/Interoperability_Panel) | Tuesdays at 16:00 Central European / 10:00 Eastern | [Meeting](https://meet.jit.si/solid-data-interoperability) |
34-
| [Authorization Panel](https://www.w3.org/community/solid/wiki/Authorization_Panel) | Wednesday at 16:00 Central European / 10:00 Eastern | [Meeting](https://meet.jit.si/solid-authorization) |
49+
All Solid UCRs are reviewed by the Diversity, Equity, and Inclusion Team
50+
([DEIT](https://github.com/solid/deit/blob/main/meetings/2021-11-09.md#deit-to-review-use-cases-in-specification-development)).
3551

52+
- Join the Solid [Panel Meetings](https://github.com/solid/specification/blob/main/README.md#solid-panels)
53+
to listen, provide insight or suggest topics for discussion.
54+
Meeting schedules, agendas and minutes can be found on the GitHub
55+
pages of each panel.
56+
Please read the
57+
[guidelines for participation](https://github.com/solid/specification/blob/main/meetings/README.md)
58+
before calling in.
59+
60+
61+
More details on how to contribute can be found [on GitHub](https://github.com/solid/specification/blob/main/CONTRIBUTING.md).
3662
All proposals undergo an Editorial review process. For more information
3763
on proposal submissions and reviews, see the
38-
[Solid Process](https://github.com/solid/process#reviewing-proposals).
64+
[Solid Process](https://github.com/solid/process).
65+
3966

40-
## Track Progress
67+
## Tracking Progress
4168

4269
Keep up-to-date with specification progress by signing up for
43-
[This Month in Solid](https://solidproject.org/newsletter).
70+
[This Month in Solid](/newsletter).
71+
Minutes of meetings are kept by each [panel](https://github.com/solid/specification/blob/main/README.md#solid-panels) to track ongoing discussions.

0 commit comments

Comments
 (0)