docs: identify the project as Apache Maka (Incubating) in both READMEs - #3391
docs: identify the project as Apache Maka (Incubating) in both READMEs#3391Astro-Han wants to merge 1 commit into
Conversation
The root READMEs still opened as "Maka" with no incubation status and no path from the repository front page to DISCLAIMER-WIP, so the first surface a reader or a release reviewer sees did not identify the project by its podling name. Rename both README titles to Apache Maka (Incubating), carry the standard ASF incubation disclaimer text near the top of each file, and link DISCLAIMER-WIP as the current record of known issues. Add a "Releases and downloads" section ahead of the existing download instructions. It states that no Apache release exists yet, that what is published today is not an ASF release and has not been through an Incubator PMC vote, and that once Apache releases exist the source release published by the ASF is the release while packages built from it and distributed elsewhere are convenience artifacts. The section deliberately does not say which convenience artifacts belong to the first release; that scope is a PPMC and mentor decision. Add the ASF trademark attribution to the license section of each README, using the wording Apache OpenDAL carries in its site footer. Add the `incubator` topic to `.asf.yaml`, extending the repository metadata that #3262 established. The description there already carries the incubating name; the topic list carried `apache` but not `incubator`. Advances #3272. It does not close it: `maka.apache.org`, the npm package page, the GitHub release surfaces, and the announcement remain open, and several of those depend on the undecided first-release scope. Generated-by: Claude Code
019e62d to
3e4ebfd
Compare
jackwener
left a comment
There was a problem hiding this comment.
Automated review of exact head 3e4ebfdfa60dfba8450c835beef7af9e7ea6b4c2.
The current main README still lacks the complete Incubator identification, disclaimer link, source-release/convenience-artifact framing, and trademark attribution. This patch adds those narrowly in both root READMEs and adds the missing incubator repository topic. The English and Chinese wording is internally consistent, links point at tracked policy files, and I found no P0-P2 defect. Required test is green on this exact head.
Merge readiness: not ready yet because repository protection still requires an independent human review. Given that this is ASF governance/branding language, the reviewing human should be a maintainer/PPMC member or mentor who can validate the policy wording, not merely the Markdown mechanics.
Summary
The root READMEs opened as "Maka", with no incubation status and no link from the repository front page to
DISCLAIMER-WIP. This applies Incubator branding to the two surfaces whose wording does not depend on the undecided first-release scope.Refs #3272
Apache Maka (Incubating), and each file carries the standard ASF incubation disclaimer text near the top with a link toDISCLAIMER-WIP..github/ASF_SOURCE_RELEASE.mdfrom release: add the ASF source candidate workflow #3269 / feat(release): add ASF source candidate workflow #3278 for the candidate contract and verification path..asf.yamlgains theincubatortopic, extending the metadata chore: add .asf.yaml for ASF infrastructure self-service #3262 established. The description there already carries the incubating name; the topic list carriedapachebut notincubator.Scope: why this is not
Fixes #3272Four of the seven exit criteria in #3272 depend on decisions that are not mine to make, so this PR deliberately stops short of them.
maka.apache.orgserves the reviewed project website rather than 404KEYSand verification instructionsThe README wording states the source-versus-convenience-artifact distinction in general terms and does not assert that npm or Desktop artifacts are part of the first release. That remains a PPMC and mentor decision under #2974.
Prior art
Wording and structure follow Apache OpenDAL. The trademark line is OpenDAL's site-footer sentence with the project name substituted. The source-versus-convenience-artifact framing matches OpenDAL's download page, which states that official releases are provided as source artifacts and keeps verification against
KEYS, GPG, and SHA-512 next to the download links.The Chinese README marks
DISCLAIMER-WIPas authoritative in English rather than translating the disclaimer as a substitute for it.Verification
npm run format— clean, no fixes applied..asf.yamlround-tripped through thestrictyamlcheck from chore: add .asf.yaml for ASF infrastructure self-service #3262 (dirty_load→as_yaml()→dirty_load): prints184 184 OK, so the folded description scalar is unpolluted, and the parsed label list contains the newincubatortopic.gh api repos/apache/makathat the live description already carries the incubating name and thatincubatoris genuinely absent from the current topics.scripts/are release-packaging code andasf-source-release.test.mjsfixtures that write their ownREADME.md..asf.yaml; none of those suites cover them..asf.yamllabel reconciliation itself can only be verified after merge, when asfyaml processes the change.AI use
Select exactly one:
Tool(s) and scope: Claude Code drafted the README changes, the
.asf.yamltopic, this description, and ran the verification above. The human contributor reviews the final diff and owns the decision to submit it. The commit carries aGenerated-by: Claude Codetrailer.Checklist
.asf.yamland were not runDoes this PR entail a change in behavior?