search

w3c / process

W3C Process Document
https://www.w3.org/policies/process/drafts/
196 stars 130 forks source link

Use Alias rather than Redirect for /Consortium/Process #729

Closed fantasai closed 5 months ago

fantasai commented 1 year ago

Currently /Consortium/Process/ performs a client-side redirect. This makes it very hard to link to the Process, since you're always on a dated snapshot. We should be encouraging links to the undated Process, not discouraging them in favor of dated snapshots. :/

frivoal commented 1 year ago

(marked as deferred not to say we should wait before we do anything about this, but in the sense that this is independent of the P2023 cycle, and therefore does not need to block it).

plehegar commented 1 year ago

My take would be to do as we do for /TR documents. Ie, no redirect.

koalie commented 1 year ago

My take would be to do as we do for /TR documents. Ie, no redirect.

That would work for W3C Comm.

plehegar commented 1 year ago

So, /Consortium/* is getting retired following the new website redesign.

So, here is what we could do:

  1. Redirect /Consortium/Process -> /Process

  2. Redirect on /Process like we do for /TR

fantasai commented 1 year ago

What is the rest of the related URL structures? I don't think Process should be top-level, it should be on the same level as the Bylaws, Patent Policy, Articles of Incorporation, etc. They should all be grouped together...

fantasai commented 1 year ago

Also could someone explain why we're deprecating URLs as part of the redesign? Is it because we have a better URL scheme in mind (what is it?) or because there's some technical limitation that requires all the new pages to be on new URLs?

plehegar commented 1 year ago

Also could someone explain why we're deprecating URLs as part of the redesign? Is it because we have a better URL scheme in mind (what is it?) or because there's some technical limitation that requires all the new pages to be on new URLs?

That seems outside the scope of the W3C Process repository issues.

koalie commented 10 months ago

I have consulted with @deniak who confirms no redirect to the dated version of the process but using a proxy instead. Before doing so, I need to close the loop with @vivienlacourba on whether we keep the existing URL or not and if not which to use. I expect this can be done within the next few weeks (to give everyone time to come back from holiday and be up to speed).

Regarding the question raised by @fantasai pertaining to the URL strategy, please refer to the recommendation from the agency we worked with for the redesign of the website.

vivienlacourba commented 8 months ago

Following discussions with @plehegar @koalie and @deniak and updates that have been introduced recently for the Code of Conduct URIs our suggestion is to use the following URIs for the W3C Process.

This allows us to move away from the dated space and the legacy /Consortium top level directory and open the path to move away from CVS in the future.

plehegar commented 7 months ago

@frivoal @fantasai , any reason not to do this ?

frivoal commented 7 months ago

I had missed this earlier. I like most of the proposal, with one exception:

* `/policies/process/` -> will proxy (and not redirect) to the latest published dated version (replaces [/Consortium/Process/](https://www.w3.org/Consortium/Process/))

* `/policies/process/YYYYMMDD/` (replaces [/2023/Process-20231103/](https://www.w3.org/2023/Process-20231103/))

* `/policies/process/drafts/` -> will proxy (and not redirect) to the editors draft on github.io https://w3c.github.io/w3process/ (replaces: [/Consortium/Process/Drafts/](https://www.w3.org/Consortium/Process/Drafts/))

All the above seems good.

* `/policies/process/drafts/YYYYMMDD/` (replaces [/Consortium/Process/Drafts/snapshots/2023-08](https://www.w3.org/Consortium/Process/Drafts/snapshots/2023-08))

I'm less sure about this one. Currently, anything under Draft/ (including Draft/snapshots/*, but also Draft/issues-*, as well as built (historical) branches such as Draft/everblue, Draft/tooling, Draft/registries…) is not managed by a formal process, but simply proxying the content of this repo. Moving the whole thing from Draft/ to drafts/ seems fine, but I'd leave everything under that as an unmanaged space proxying the whole of what's under https://w3c.github.io/w3process/.

If you do want to put a bit of order into what's in that space, I think we could talk about that too, but as there's a lot of things in that space, I'd suggest a separate issue to discuss it.

fantasai commented 7 months ago

@vivienlacourba Where will the Bylaws live? I think Process probably belongs in a parallel location...

plehegar commented 5 months ago

Looking above, we agreed on:

* `/policies/process/` -> will proxy (and not redirect) to the latest published dated version (replaces [/Consortium/Process/](https://www.w3.org/Consortium/Process/))

* `/policies/process/YYYYMMDD/` (replaces [/2023/Process-20231103/](https://www.w3.org/2023/Process-20231103/))

* `/policies/process/drafts/` -> will proxy (and not redirect) to the editors draft on github.io https://w3c.github.io/w3process/ (replaces: [/Consortium/Process/Drafts/](https://www.w3.org/Consortium/Process/Drafts/))

What happens below /policies/process/drafts/* will continue to be managed by this repo.

Unless we hear otherwise, we'll close this issue with this conclusion.

frivoal commented 5 months ago

Where will the Bylaws live? I think Process probably belongs in a parallel location...

Currently they're at https://www.w3.org/2022/10/w3c-bylaws-20221019. It might be reasonable to move them to that /policies/* space too indeed.

I note that the CoC already lives there (https://www.w3.org/policies/code-of-conduct/), as well as the antitrust policy (https://www.w3.org/policies/antitrust/) or the privacy policy (https://www.w3.org/policies/privacy/), which seems appropriate, but that the Patent Policy does not: It's at https://www.w3.org/Consortium/Patent-Policy/, and like the current Process (and unlike what we're proposing to do here), it redirects (not proxies) to the latest dated version.

I feel less strongly about the bylaws, but I'd suggest doing the same for the Patent Policy as we're proposing doing for the Process.

plehegar commented 5 months ago

Waiting on #871 to happen, then @vivienlacourba and @deniak will do the redirects for Process and PP, then update pubrules to accept old and new dated 20231106 process version and old/new patent policy links, and then do pull requests for bikeshed/respec.

koalie commented 5 months ago

Hi all, @vivienlacourba and I met today (after he met yesterday with @plehegar) to decide on the following implementation details:

  1. "this version" URI + "latest" URI to be edited in place; entry to be added in the "changes" section with date of change and explanation
  2. no need to perform the same change of URIs for previous versions
  3. this applies to both the Process Document and the Patent Policy
frivoal commented 5 months ago

@koalie I think you mean this needs to happen not only in the Editor's Draft, but also in the published versions, is that right? The team will need to handle the already published version, but I'm happy to handle the Editor's Drafts. Just let me know:

koalie commented 5 months ago

@koalie I think you mean this needs to happen not only in the Editor's Draft, but also in the published versions, is that right?

Yes the editors draft should be updated accordingly to reflect this change.

The team will need to handle the already published version, but I'm happy to handle the Editor's Drafts. Just let me know:

* when we're ready to go live with this

Will do!

* if there's a particular phrasing you'd like to see in the changelog explaining why we're doing this

@vivienlacourba suggested wording which I like: " this document URI was changed from /Consortium/Process/ to /policies/process/ for better integration in the W3C website architecture."

deniak commented 5 months ago

The process document has now been moved under /policies:

vivienlacourba commented 5 months ago

The process document has now been moved under /policies:

Thank you @deniak !

@plh @frivoal you can now take care of updating the editors draft accordingly with the new URIs of the Process doc and patent policy.

frivoal commented 5 months ago

You can now take care of updating the editors draft accordingly with the new URIs of the Process doc and patent policy.

Done.

vivienlacourba commented 5 months ago

You can now take care of updating the editors draft accordingly with the new URIs of the Process doc and patent policy.

Done.

Thanks @frivoal. I think there are 3 other files in that repo that seem worth updating, namely: README.md, CONTRIBUTING.md and compile.sh

Same comment on the Patent Policy repo which has README.md and CONTRIBUTING.md

frivoal commented 5 months ago

@vivienlacourba Thanks, nice catch. Should be fixed now.