search

w3c / deviceorientation

W3C Device Orientation spec
https://www.w3.org/TR/orientation-event/
Other
49 stars 32 forks source link

"Status of this document" section needs to reflect join deliverable status #145

Closed reillyeon closed 2 months ago

reillyeon commented 3 months ago

As discussed in https://github.com/w3c/deviceorientation/pull/142 the "Status of this document" section does not sufficiently reflect the joint deliverable status of this specification. That CL adds "text macro" declarations which should be sufficient but there appear to be deficiencies in the Bikeshed boilerplate text which need to be addressed.

In particular, the line "This document was produced by the Devices and Sensors Working Group." should read something like "This document was produced as a joint deliverable of the Devices and Sensors Working Group and Web Applications Working Group."

We also found that while there is a section on the W3C Patent Policy which acknowledges the joint deliverable status it would also be helpful for the document to also be explicit about the need to satisfy the success criteria for both groups.

himorin commented 3 months ago

added a PR to boilerplate https://github.com/speced/bikeshed-boilerplate/pull/62

We may write as Working Group<span include-if="Text Macro: JOINT">(s)</span>, but I'm not sure meaning less <span> will pass pubrules.

anssiko commented 3 months ago

@himorin thanks for the updates.

Because pubrules checker does not seem to fully understand the joint deliverable concept yet, I suggest we update SOTD to acknowledge both the groups as appropriate and @himorin opens a pubrules bug to report this issue and links to that bug in the transition request.

In general, SOTD should make sure both the groups are equally acknowledged. For all applicable instances of:

himorin commented 3 months ago

filed as https://github.com/w3c/specberus/issues/1818 I see no other warning than stability section, so I've pointed only that.

himorin commented 3 months ago

@anssiko checking webapps boilerplate, mail list is no longer used for webapps, like https://github.com/speced/bikeshed-boilerplate/blob/04c228c0b6d949ed55b4f13bb6d91c139ab6e317/boilerplate/webapps/status-WD.include#L20C1-L21C103

    Historical discussions can be found in the
    <a href="https://lists.w3.org/Archives/Public/public-webapps/">public-webapps@w3.org archives</a>.

@marcoscaceres @siusin do you have any recommendation on this point?

Also a PR to boilerplate updated.

siusin commented 3 months ago

public-webapps@ is still active, it's all right to take Anssi's suggestion. The WebApps WG charter says:

This group primarily conducts its technical work on the public mailing list public-webapps@w3.org (archive), and on GitHub issues.

Most of the WebApps WG specs are using GitHub issues to collect feedback, instead of the mailing list though.

I wonder if it's possible to use: please send them to public-device-apis@w3.org (subscribe, archives) -> please file an issue in https://github.com/w3c/deviceorientation GitHub repository, or send them to public-device-apis@w3.org (subscribe, archives) and public-webapps@w3.org (subscribe, archives)

himorin commented 3 months ago

@siusin thank you for confirmation. updated PR.

marcoscaceres commented 3 months ago

Should we bother with the mailing lists at all? At least, we don't want new comments going to the mailing list... they should only go to GitHub.

anssiko commented 2 months ago

Fixed by manually published https://www.w3.org/TR/2024/WD-orientation-event-20240411/ per https://lists.w3.org/Archives/Public/public-device-apis/2024Apr/0005.html -- closing.