You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
README: Add links to rendered pages, editorial updates (#373)
This adds links to the rendered HTML pages next to the mentions of the
folders so that people can quickly check the contents of the underlying
section in the guidebook. Fixes#314.
This also fixes a couple of typos and links.
Copy file name to clipboardExpand all lines: README.md
+16-15Lines changed: 16 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,8 +2,7 @@
2
2
3
3
The repository for "[The Art of Consensus](https://www.w3.org/guide/)", W3C's Chair's Guidebook.
4
4
5
-
Documentation on how to participate in W3C WGs is split between multiple wikipages, github repos and emails. This means new members find difficulty in finding information as to how to participate and maybe give up trying. This repository is the place to pull all of those
6
-
together.
5
+
Documentation on how to participate in W3C Working Groups is split between multiple wikipages, github repos and emails. This means new members find difficulty in finding information as to how to participate and maybe give up trying. This repository is the place to pull all of those together.
7
6
8
7
## Got a question?
9
8
@@ -17,38 +16,40 @@ The general edition of the Guidebook is managed by [@w3c/guidebook](https://gith
17
16
18
17
The Guidebook uses the [W3C Jekyll theme](https://github.com/w3c/w3c-jekyll-theme). See the [README](https://github.com/w3c/w3c-jekyll-theme/blob/main/README.md) to run Jekyll locally.
19
18
20
-
Note that latest versions of Ruby might created a [dependency issue]([url](https://github.com/jekyll/jekyll/pull/9392)). It is recommended to use the Ruby version mentioned in the [Github workflow]([url](https://github.com/w3c/guide/blob/1a2821f048c40648a9623ac8bd46056991e30b89/.github/workflows/jekyll-gh-pages.yml#L21)).
19
+
Note that latest versions of Ruby might create a [dependency issue](https://github.com/jekyll/jekyll/pull/9392). It is recommended to use the Ruby version mentioned in the [Github workflow](https://github.com/w3c/guide/blob/main/.github/workflows/jekyll-gh-pages.yml#L21).
21
20
22
21
## In this repository
23
22
24
23
*[/chair/](chair)
25
-
* Instructions on how to chair WGs and IGs including managing meetings, setting up the homepage, maintaining the calendar.
24
+
*[Resources for Group Chairs](https://www.w3.org/guide/chairs/).
25
+
* Instructions on how to chair Working Groups and Interest Groups including managing meetings, setting up the homepage, maintaining the calendar.
26
26
*[/council/](council)
27
-
* Anything related to councils.
27
+
*[Anything related to W3C Councils](https://www.w3.org/guide/chairs/).
28
28
*[/documentreview/](documentreview)
29
-
* How to do [wide review](https://www.w3.org/guide/documentreview/).
29
+
*[How to do wide review](https://www.w3.org/guide/documentreview/).
30
30
*[/editor/](editor)
31
-
*[W3C Editors' Home Page](https://www.w3.org/guide/editor/).: How to author a specification, including ReSpec or other spec making programs.
31
+
*[W3C Editors' Home Page](https://www.w3.org/guide/editor/).
32
+
* How to author a specification, including ReSpec or other spec making programs.
32
33
*[/github/](github)
33
-
* How to use Git and GitHub at W3C.
34
+
* How to use [Git and GitHub at W3C](https://www.w3.org/guide/github/).
34
35
*[/manual-of-style/](manual-of-style)
35
36
* The [W3C Manual of Style](https://www.w3.org/guide/manual-of-style/) for editors.
36
37
*[/meetings/](meetings)
37
-
*Anything related to organizing meetings, including events.
38
+
*[Resources about W3C Meetings](https://www.w3.org/guide/manual-of-style/), including events.
38
39
*[/process/](process)
39
-
*Anything related to additional guidelines when following the process.
40
+
*[Procedures related to the W3C Process](https://www.w3.org/guide/process/).
40
41
* You may involve [@w3c/w3process-editors](https://github.com/orgs/w3c/teams/w3process-editors).
41
42
*[/process/tilt/](process/tilt)
42
43
* Anything related to [technical Team decision and verification](https://www.w3.org/guide/process/tilt/), except for transitions.
43
44
* Managed by [@w3c/tilt](https://github.com/orgs/w3c/teams/tilt)
44
-
*[/standards-track/](standards-track).
45
-
* Best Practices for Bringing Work to the W3C Recommendation Track.
45
+
*[/standards-track/](standards-track)
46
+
*[Best Practices for Bringing Work to the W3C Recommendation Track](https://www.w3.org/guide/standards-track/).
46
47
*[/teamcontact/](teamcontact)
47
-
* Guidance on the role of the team contact, and what to expect from them.
48
+
*[Guidance on the role of the team contact](https://www.w3.org/guide/teamcontact/), and what to expect from them.
48
49
*[/transitions/](transitions)
49
50
*[Organize a Technical Report Transition](https://www.w3.org/guide/transitions/).
50
51
* Managed by [@w3c/transitions](https://github.com/orgs/w3c/teams/transitions).
51
52
*[/other/](other)
52
-
*Related to [permanent groups](https://www.w3.org/groups/).
53
+
*[Additional guidelines](https://www.w3.org/guide/other/) that do not fit under main categories, notably guidelines related to [permanent groups](https://www.w3.org/groups/).
53
54
54
-
Note: now that we have a repository for the guidebook, simply add your documentation to it, rather than creating new repositories.
55
+
**Note:** now that we have a repository for the guidebook, simply add your documentation to it, rather than creating new repositories.
0 commit comments