You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@magpie.apache.org by "justinmclean (via GitHub)" <gi...@apache.org> on 2026/07/29 00:15:32 UTC

[I] Fix the README describing MISSION.md as a draft proposal in one place and established in another [magpie]

justinmclean opened a new issue, #1006:
URL: https://github.com/apache/magpie/issues/1006

   ## Summary
   
   `README.md` describes `MISSION.md` two contradictory ways in the same file: once as the
   founding mission of an established project, once as a draft proposal. Make them agree.
   
   ## Background
   
   Apache Magpie was established as a Top-Level Project by Board resolution, and PR #817 updated the
   docs to reflect that — including `README.md` line 48, which now calls `MISSION.md` "the
   founding mission of the established TLP", and a status banner added to `MISSION.md` itself
   marking the document as the original establishment proposal kept as a historical record.
   
   The Cross-references list near the bottom of `README.md` was not updated. It still reads:
   
   ```markdown
   - [`MISSION.md`](MISSION.md) — **draft** project-establishment proposal: motivation, scope,
     design commitments, initial PMC composition target.
   ```
   
   So the same file tells a reader the project is established at line 48 and still proposed at line
   238. "Draft proposal" is exactly the framing #817 set out to remove.
   
   ## Where to look
   
   - `README.md` line 238 — the Cross-references entry to update.
   - `README.md` line 48 — the wording #817 landed, for the tone to match.
   - `MISSION.md` — the status banner at the top, which describes what the document now is.
   
   Keep the useful part of the description (motivation, scope, design commitments); only the "draft
   project-establishment proposal" characterisation needs to change.
   
   ## Acceptance criteria
   
   - [ ] The Cross-references entry no longer calls `MISSION.md` a draft or a proposal-in-progress.
   - [ ] It is consistent with line 48 and with the status banner in `MISSION.md`.
   - [ ] The entry still says what a reader will find in the document.
   - [ ] `prek run --all-files` passes.
   
   ## Estimated effort
   
   ~20 minutes for someone new to the codebase.
   
   ## Getting started
   
   [[How to contribute](https://github.com/apache/airflow-steward/blob/main/CONTRIBUTING.md#your-first-contribution)](https://github.com/apache/airflow-steward/blob/main/CONTRIBUTING.md#your-first-contribution)
   
   This issue was drafted with the help of an AI-assisted tool and reviewed by a Magpie maintainer before posting. If anything here is unclear or looks wrong, say so on the issue: a real person is reading.


-- 
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: commits-unsubscribe@magpie.apache.org.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


Re: [I] Fix the README describing MISSION.md as a draft proposal in one place and established in another [magpie]

Posted by "NekomyaDev (via GitHub)" <gi...@apache.org>.
NekomyaDev commented on issue #1006:
URL: https://github.com/apache/magpie/issues/1006#issuecomment-5123572737

   Taking this one — same one-liner spirit as #1000. Plan: rewrite the Cross-references entry to match line 48's framing (founding mission of the established TLP, original proposal kept as a historical record) and drop the **draft** characterisation, keeping the motivation/scope/design-commitments pointer. PR coming up.


-- 
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: commits-unsubscribe@magpie.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


Re: [I] Fix the README describing MISSION.md as a draft proposal in one place and established in another [magpie]

Posted by "potiuk (via GitHub)" <gi...@apache.org>.
potiuk closed issue #1006: Fix the README describing MISSION.md as a draft proposal in one place and established in another
URL: https://github.com/apache/magpie/issues/1006


-- 
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: commits-unsubscribe@magpie.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org