Skip to content

Commit

Permalink
Update links and markdown
Browse files Browse the repository at this point in the history
  • Loading branch information
vivienlacourba committed Jan 9, 2025
1 parent 381a557 commit 87b17c5
Showing 1 changed file with 26 additions and 32 deletions.
58 changes: 26 additions & 32 deletions tools/new-group.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: How to setup a new Working Group or Interest Group
toc: true
---

Once the [decision of creating a new group](../process/charter.html#join-form) has been announced and the group effectively exists, there are considerations for the setup. This document suggests a Group setup for the various W3C tools.
Once the [decision of creating a new group](../process/charter.md#join-form) has been announced and the group effectively exists, there are considerations for the setup. This document suggests a Group setup for the various W3C tools.

## 1. Administrivia repository {#administrivia}

Expand All @@ -22,21 +22,15 @@ For this repository, you may use the naming convention ***`w3c/{shortname}{type}

By default, the W3C website will have a homepage for the Group, maintained by various W3C systems and accessible through the [Group pages](https://www.w3.org/groups/). For simplicity and ease of maintenance, we recommend that you point your participants to that group page. Additional links can be added by the Team in the "Tools" page of the Group if needed.

However, if your group do feel the need to maintain a dedicated
homepage, place it in your group administrivia repository and ask to
expose it through w3.org as a proxy (Team should look at [W3C Web
rewrites system](https://www.w3.org/2019/03/rewrites-doc.html)). Don't
forget to set the [`w3c.json`
file](https://w3c.github.io/w3c.json.html) appropriately (***`repo-type:
"homepage"`***).
However, if your group do feel the need to maintain a dedicated homepage, place it in your group administrivia repository and ask to expose it through w3.org as a proxy (Team should look at [W3C Web rewrites system](https://www.w3.org/2019/03/rewrites-doc.html)). Don't forget to set the [`w3c.json` file](https://w3c.github.io/w3c.json.html) appropriately (***`repo-type: "homepage"`***).

## 3. Github repositories {#repositories}

All GitHub repositories used by the group must indicate so, using the [`w3c.json` file](https://w3c.github.io/w3c.json.html) in those repositories. If you do not use the GitHub 'w3c' organization, make sure the Team associates your GitHub organization in the 'Version Control' entry of the Tools page (Team may modify those entries using the [admin](https://w3.org/admin) interface) and the tooling will associate *by default* all of the repositories in your GitHub organization to your group.

Make sure the license and code of conduct files are there (Team, you may use the [repository manager](https://labs.w3.org/repo-manager/) to create those).

If a repository needs to be moved across organizations, the Team can help. By default, we recommend one github repository per technical documents as well as one administrvia repository.
If a repository needs to be moved across organizations, the Team can help. By default, we recommend one GitHub repository per technical documents as well as one administrvia repository.

All group repositories will appear on the 'Tools' page.

Expand All @@ -48,54 +42,54 @@ The W3C system can generate and maintain 2 GitHub teams: Chairs/Team Contacts (*

To help W3C participants navigate through the various groups, Chairs and Team Contacts must use the W3C Calendar system rather than using separate tools. By default, recurring meetings must be 'Tentative', confirming only meetings that will actually happen or cancelling them otherwise. For TPAC meetings, the events Team will create specific calendar entries. Each meeting should point to where the agenda and minutes did or will appear.

To use zoom, see [Scheduling a Zoom Conference](https://www.w3.org/Guide/meetings/zoom).
To use Zoom, see [Scheduling a Zoom Conference](../meetings/zoom.md).

## 6. Agenda {#agenda}

To allow the broadest participation in setting meeting agendas, we recommend opening a GitHub issue in your administrivia repository, with a label "**`agenda`**", one issue per meeting. There is at least one issue opened at all time for the next future meeting. You may use a GitHub template to facilitate the creation of such agenda issue.

Encourage participants to comment on the issue in order to add agenda items. Your participants may also add a label "**`agenda+`**" on any issue in technical specifications. If so, Chairs should monitor the [agenda board](/PM/Groups/agendas.html) to catch those (and remove the label once if the issue got covered in a meeting).
Encourage participants to comment on the issue in order to add agenda items. Your participants may also add a label "**`agenda+`**" on any issue in technical specifications. If so, Chairs should monitor the [agenda board](https://www.w3.org/PM/Groups/agendas.html) to catch those (and remove the label once if the issue got covered in a meeting).

Your calendar entry should point to the appropriate GitHub issue (or a search link to find it).

Chairs are reminded of the [Meeting Scheduling and Announcements](https://www.w3.org/policies/process/#meeting-schedules) expectations.

In ***`.github/ISSUE_TEMPLATE/agenda.md`***:

```
---
name: Meeting agenda
about: Agenda discussion for a given group meeting
title: '[agenda] 2025-xx-xx'
labels: 'agenda'
assignees: 'chairgithubhandle[,chairgithubhandle]*'
```markdown
---
name: Meeting agenda
about: Agenda discussion for a given group meeting
title: '[agenda] 2025-xx-xx'
labels: 'agenda'
assignees: 'chairgithubhandle[,chairgithubhandle]*'

---
---

## Proposed Agenda
## Proposed Agenda

1. Introductions, Code of Conduct
1. agenda item 2
1. agenda item 3
1. agenda item 4
1. AOB
1. Introductions, Code of Conduct
1. agenda item 2
1. agenda item 3
1. agenda item 4
1. AOB

---

---
Please add comments to this issue if you have suggestions for agenda items.

Please add comments to this issue if you have suggestions for agenda items.
```

## 7. Chairs and Team Contacts {#chairs-and-tcs}

The Team must ensure that Chairs and Team Contacts are appropriately identify in the [Group pages](https://www.w3.org/groups/) (Team should use the [admin](https://w3.org/admin) interface to do so). Chairs and Team Contacts may want to schedule a regular (weekly, bi-weekly, monthly, quaterly?) meeting to sync-up and track group progress.
The Team must ensure that Chairs and Team Contacts are appropriately identified in the [Group pages](https://www.w3.org/groups/) (Team should use the [admin](https://www.w3.org/admin/) interface to do so). Chairs and Team Contacts may want to schedule a regular (weekly, bi-weekly, monthly, quaterly?) meeting to sync-up and track group progress.

Team Contacts should ensure that new Chairs get appropriate onboarding, including from the W3C Project Management Lead.

See also:

- [W3C Chair Buddy System](../chair/buddy.html)
- [Working Groups](https://www.w3.org/PM/Groups/chairboards.html?gtype=working) and [Interest Groups](https://www.w3.org/PM/Groups/chairboards.html?gtype=interest) dashboards
- [W3C Chair Buddy System](../chair/buddy.md).
- [Working Groups](https://www.w3.org/PM/Groups/chairboards.html?gtype=working) and [Interest Groups](https://www.w3.org/PM/Groups/chairboards.html?gtype=interest) dashboards.

## 8. Invited Experts {#invited-experts}

Expand All @@ -109,7 +103,7 @@ In ***`invited-experts.md`***:

To help with consistency, you should maintain those invited expert expectations in your group administrivia repository so that it can be easily revised or pointed to.

Chairs and Team Contacts should keep track of invited applications (accessible from the group participants list) and process them on an ongoing basis.
Chairs and Team Contacts should keep track of invited expert applications (accessible from the group participants list) and process them on an ongoing basis.

## 9. Onboarding {#onboarding}

Expand Down

0 comments on commit 87b17c5

Please sign in to comment.