potiuk opened a new issue, #76875:
URL: https://github.com/apache/airflow/issues/76875

   The AIP and ADIP sections of the wiki are now organised by state. Each 
proposal sits in a state folder (Work in progress, Under discussion, Accepted, 
Completed, Abandoned or replaced), with a matching State badge in its Page 
Properties block and a matching state label. The index pages build their lists 
from the folders.
   
   Changing the state of a proposal therefore takes several manual steps:
   
   1. move the page to the folder for the new state,
   2. change the State badge,
   3. replace the state label (`airflow-improvement-proposal/<state>` or 
`adip/<state>`),
   4. update the count in the folded Completed / Abandoned header on the index 
page when the proposal moves in or out of those folders.
   
   Missing one of them puts the proposal in the wrong list. The daily check in 
#76845 then reports it to Slack.
   
   **Proposal**
   
   Add a small "Move to: <state> [Apply]" control to every AIP and ADIP page. 
Clicking it does all four steps at once through the Confluence REST API, and 
can add a version comment (for example a link to the vote thread).
   
   cwiki (Confluence 9.2) has the `html` macro enabled, and it passes scripts 
through, so the control can run in the viewer's own session. Confluence 
enforces permissions on the REST calls, so only people with edit rights on the 
page can change its state.
   
   **Things to settle first**
   
   * **Security:** a script in an `html` macro runs for every logged-in viewer, 
and anyone who can edit the page can change it. The script should live on one 
page that only PMC members can edit, and be pulled in from there rather than 
copied into each AIP page.
   * **ASF Infra:** check that relying on the `html` macro is acceptable, and 
that it is not going to be disabled.
   * **Rollout:** the AIP and ADIP templates (including the WIP variants) need 
the control, and so do the existing pages.
   
   **Alternatives considered**
   
   * A scheduled job that reacts to a label change and does the move, badge and 
count updates. It needs a wiki token stored as a repository secret.
   * A bookmarklet for committers. No secrets are involved, but each person has 
to set it up and it is hard to discover.
   
   Related: #76845 (daily consistency check for the AIP / ADIP wiki trees).
   
   ---
   Drafted-by: Claude Opus 5; reviewed by @potiuk before posting
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to