luigidemasi opened a new issue, #162:
URL: https://github.com/apache/camel-kit/issues/162

   Camel Kit's documentation is published at 
https://camel.apache.org/camel-kit/next/ from `docs/modules/ROOT/` of this 
repository. A few things in the repository still predate the move to Apache or 
duplicate the published pages.
   
   ## Links
   
   - `kit/README.md`: the Documentation badge links the AsciiDoc source 
(`../docs/modules/ROOT/pages/index.adoc`); point it at 
https://camel.apache.org/camel-kit/next/. The root `README.md` "Getting 
started" section links the same source; add the published address.
   - `CONTRIBUTING.md` line 44: `git remote add upstream 
https://github.com/luigidemasi/camel-kit.git` should be 
`https://github.com/apache/camel-kit.git`.
   - Issue links to the former repository: `docs/ship-claude.md` (#222, copied 
here as #93), `docs/ship-codex.md` (#225 → #96), `docs/ship-copilot.md` (#226 → 
#97), `docs/ship-native.md` (#223 → #94 and #221 → #92) and 
`docs/user-guide.md` (#213 → #89).
   
   ## Duplicated Markdown documentation
   
   `docs/*.md` predates the Antora pages and overlaps them. Keep 
`docs/constitution.md`, `docs/commands.md` and `docs/architecture.md`: 
`ResourceConsistencyTest` and `ShippedAssetStructureTest` read them, and the 
workflow manifest (`camel-kit-workflow.yaml`) references `docs/commands.md`, 
`docs/architecture.md` and `docs/user-guide.md`. For the others 
(`user-guide.md`, `camel-kit-overview.md`, `antigravity.md`, 
`agent-architectures.md`, `ship-claude.md`, `ship-codex.md`, `ship-copilot.md`, 
`ship-native.md`): either turn them into short pointers to the corresponding 
Antora page, keeping the manifest reference to `user-guide.md` valid, or move 
the contributor-only content into `CONTRIBUTING.md`. `docs/releasing.md` stays 
as contributor process documentation.
   
   ## Already done
   
   - The dead `pages.yaml` and `website-impact.yml` workflows were removed by 
#138.
   - `.asf.yaml` already names camel.apache.org as the homepage.
   
   Website impact: not required (the published pages do not change).
   
   _AI-generated by Claude Fable 5.1 on behalf of @luigidemasi._


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