Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

add affect-specs column to finished-proposals #140

Open
ericprud opened this issue Apr 11, 2022 · 2 comments
Open

add affect-specs column to finished-proposals #140

ericprud opened this issue Apr 11, 2022 · 2 comments

Comments

@ericprud
Copy link

It will be easier to reference changes from versioned docs if the affected docs (core, js-api, web-api) are listed in a column next to the date

@dschuff
Copy link
Member

dschuff commented Apr 12, 2022

#141 implements this.
Having said that, this isn't the only way to provide the metadata about which proposal affects which specs (or even necessarily the best). Could you say a little more about how you expect the spec publication workflow to work, and how this information would be used?

@ericprud
Copy link
Author

The W3C publication process promises changes since the last published version. In this case, we're going from the published v1 REC to a 1.1 first public working draft (FPWD). The spirit of this commitment is to offer folks a high-level view of what's changed since they last looked at doc. This guides the public who can see the progress and guides internal review from e.g. accessibility or internationalization who can scan the changes and decide if any new feature falls into their domain.

I'm not entirely sure how auto-publish (echidna) will operate going forward, but this is mostly to meet the requirement for the FPWDs and maybe give other finished-proposals readers a sense of what happened where.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants