I created an issue https://github.com/apache/airflow/issues/76875 describing how such "status change macro" could be implemented if we decide we want it.
For now I finally feel that I know what's going on with AIPs. It was really a bit of chatting with Claude, and I think the clarity of where we are, what is in progress, etc. is at least an order of magnitude easier. When we merge 76845, it will not only be like that, but it will remain like that in the future. The status change macro might also help if we see that handling alerts becomes somewhat problematic to handle the alerts when you update the AIPs/ADIPs in an unexpected way. J. On Tue, Nov 10, 2026 at 3:19 PM Jarek Potiuk <[email protected]> wrote: > While moving the ADIPs out, I also restructured the AIP section of the wiki > so that its lists maintain themselves, did the same for the ADIP index, and > tidied up a few related parts of the wiki. > > What changed: > > * Every AIP now sits in a folder for its state, all at the same level: > Work in progress, Under discussion, Accepted, Completed, (AIPs moved to > ADIP), Abandoned or replaced. Sub-AIPs that were nested under umbrella > AIPs > (AIP-64..66, 74..76, 84) moved into their state folders too; the umbrella > section still lists the umbrella AIPs by label. > > * Each AIP page has a State badge (WIP, Under discussion, Accepted, > Completed, Abandoned) at the top of its Page Properties block, with the > extra detail kept next to it (e.g. "Superseded by AIP-66"). The labels > were refreshed to match - about 40 pages had stale or conflicting ones. > > * The lists on the AIP index page are generated from the folders, sorted by > number. Completed and Abandoned are folded by default, with the count in > the header. To change an AIP's state, move its page to the matching > folder > and update its State badge. The only hand-kept bits are the two counts in > the folded headers - when an AIP moves in or out of Completed or > Abandoned, > update the number there (the daily check flags it if you forget). > > * ADIPs are grouped the same way, in the same state folders under the ADIP > page, with the same badges and generated lists (ADIP, State, Formerly). > ADIP-9 (in progress) is under Accepted, ADIP-11 and ADIP-12 under > discussion. The ADIP titles no longer carry "(formerly AIP-N)" - that is > a property now. The pages under the old AIP titles still redirect to the > ADIPs. > > * Dev call minutes are grouped by year and month (e.g. 2026 Dev Calls > > 2026-11 Dev Calls > 2026-11-05 Dev call Minutes). The single 2024 page is > split into one page per call, like 2025 and 2026; its page history keeps > the original. > > * The Airflow 3.1 - 3.4 test plans moved under their release pages, like > the 3.0 one,. > > * Town Hall recordings now have a page per meeting, grouped by year, under > Regular Town Hall and Dev Call > Airflow Town Hall - 18 recordings from > March 2025 to October 2026 found on the Apache Airflow YouTube channel. > If you know where the earlier ones (or Jan/Feb/Oct 2025, Jan 2026) are, > please add them. > > * some of the "summaries" on YouTube videos were copy&pasted between > videos - so I extracted the summary from the video itself (Agents are > amazing) > > * ADIPs and AIPs sub-structure follow the same approach - the overview > page contains A*IPs groupped by status in the sequence: > Work in Progress -> Under Discussion -> Accepted -> Umbrella -> > Completed -> Abandoned > and Completed / Abandoned are folded by default showing a number > of those. > > A daily check (https://github.com/apache/airflow/pull/76845) verifies the > AIP > and ADIP structure and posts to #internal-airflow-ci-cd (for now) when > something > drifts - a page in the wrong folder, a State that does not match it, > missing labels or a stale count. > > We could also implement a mini-workflow (but I refrained for now) > to be able to just one-click change the status of the AIPs (It would > require > custom HTML macro, but I do not think this is something we would really > want - the "guard" workflow should be enough for a while and we should > see if this is needed. > > Pages where the State said "Draft" but that had already been moved to the > Abandoned folder ended up as Abandoned (AIP-2, 37, 54, 70, 94 and the > task-level circuit breaker proposal). AIP-52 has edit restrictions, so its > labels and badge could not be updated - if it is yours, please add the > badge. > > This is just a structure that made sense to me while doing the move. If you > see a better one - different states, columns or grouping - feel free to > change it, and update the check along with it. > > AIP index: > https://cwiki.apache.org/confluence/spaces/AIRFLOW/pages/89066602/AIP+-+Airflow+Improvement+Proposals > ADIP index: > https://cwiki.apache.org/confluence/spaces/AIRFLOW/pages/462816431/ADIP+-+Airflow+Development+Improvement+Proposals > Town Halls and Dev Calls: > > https://cwiki.apache.org/confluence/spaces/AIRFLOW/pages/406621773/Regular+Town+Hall+and+Dev+Call >
