Feedback email in addition to GitHub

[shawna-slh]

PubRules currently states:

Document identifier information must be present in this order:
...
Feedback - GitHub repository issue links are required in the <dl>after <dt>Feedback:</dt> in the headers (<div class="head">) of the document. Links are expected to be of the form https://github.com/<USER_OR_ORG>/<REPO_NAME>/[issues|labels][/…].)

I propose that we also provide an email address for feedback.

Rationale: Not everyone uses GitHub. It can comes across as exclusionary if the only way to provide feedback that is listed is GitHub — which is the opposite of what we want to convey.

An example that includes email: https://www.w3.org/reports/identity-web-impact/

[deniak]

I think the original idea was that since the spec is being develop on GH, we want to have a central place to gather feedback instead of having comments spread all over the place. See #629 and #408.
Pubrules only checks TR documents and submissions so other types of documents don't have that requirement.

/cc @plehegar

[plehegar]

Indeed, we removed the requirement several years ago because of less of our groups are using their mailing list. For those, sending an email will likely get missed.

[shawna-slh]

CC: @iadawn @daniel-montalvo @ruoxiran

I understand the rationale. And I still think it's exclusionary.

For WAI docs, we will want to avoid that - and provide an email option.

Request:

Would it be OK to provide a template format to include GitHub and email, and just not make it a requirement?

draft suggestion for Feedback section that includes both:

Preferred: GitHub w3c/ai-web-impact — new issue, pull requests, open issues
If not GitHub, email: public-team-report-comments@w3.org with subject line starting “[AI-web-impact]” (archives)

Related info:

Example with email address (with wonky text formatting): https://www.w3.org/reports/identity-web-impact/

Here's an example of what we say in email announcements,:

To comment, please open a new issue in the CTAUR GitHub repository:
https://github.com/w3c/ctaur/issues/new
Please create separate GitHub issues for each topic, rather than commenting on multiple topics in a single issue.

If it's not feasible for you to use GitHub, send comments in email to: public-rqtf@w3.org
Please:

• put your comments in the body of the message, not as an attachment
• start your e-mail subject line with: [CTAUR]

[deniak]

Note that some groups are already using that format in the list of feedback options, e.g. https://www.w3.org/TR/rdf12-concepts/.

Pubrules only checks that a link to the repository issues is provided. Other ways are optional and I don't think we want/can force groups to provide a mailing list.