jethac opened a new issue, #42989:
URL: https://github.com/apache/superset/issues/42989

   ### Problem
   
   Three pieces of documentation describe machinery or state that does not 
exist. Each misleads a new contributor — and, increasingly, any coding agent 
reading them as ground truth.
   
   **1. `.claude/projects/js-to-ts/PROJECT.md` says 219 JavaScript files remain 
to convert.**
   Measured today: **6** `.js`/`.jsx` files across `superset-frontend/src`, 
`packages` and `plugins`. `src/` is at zero. The migration is done in 
application code; the playbook describes a finished job.
   
   **2. `docs/developer_docs/contributing/issue-reporting.md` documents an 
issue lifecycle that does not run.**
   It describes a bot marking issues stale after 30 days and closing them 7 
days later. There is no stale workflow among the repository's workflows. 
`.github/stale.yml` still exists and configures probot/stale, which is not 
installed. The same page documents status labels `needs-triage`, `confirmed`, 
`in-progress` and `blocked`; none of them exist in the repository's label set.
   
   **3. `LLMS.md` was renamed to `AGENTS.md`, but three docs still reference 
the old name:**
   ```
   docs/developer_docs/contributing/development-setup.md
   
docs/developer_docs_versioned_docs/version-6.1.0/contributing/development-setup.md
   docs/user_docs_versioned_docs/version-6.0.0/contributing/development.mdx
   ```
   
   ### Proposed change
   
   Correct each to describe what is actually true, or delete the parts 
describing machinery that no longer exists. Where something is an aspiration 
rather than a fact, saying so explicitly is enough.
   
   Verified against `master` at `3539c41dab`.


-- 
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]


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to