slachiewicz opened a new issue, #1751: URL: https://github.com/apache/maven-site/issues/1751
Several how-to pages that explain Maven concepts live in component sites, so they publish only when that component is released, and some duplicate a guide that already exists here. This moves them into maven.apache.org guides, where they publish with the next site build, and leaves the component sites with their goal reference and component-specific examples. Each topic is one maven-site PR and one component PR: 1. The maven-site PR adds or extends the guide and adds a `Redirect Permanent` line in `content/filtered-resources/.htaccess` for every published URL it replaces. The model XSDs link to the SCM and toolchains pages, so those redirects are required. 2. The component PR deletes the pages and links to the guide. It merges after the site is published. Snippets use the `version.maven-*-plugin` properties inherited from maven-parent, so plugin versions in the guides follow parent bumps instead of being pinned by hand. Overlaps with existing guides: - [ ] Manifests: maven-archiver `examples/manifest*`, `classpath` into `guide-manifest` and `guide-archive-configuration` - [ ] Reproducible builds: maven-artifact-plugin `reproducible` into `guide-reproducible-builds` - [ ] Creating a site: maven-site-plugin `creating-content`, `multimodule`, `creatingskins`, `i18n`, `filtering-content` into `guide-site` and `skins/` - [ ] Mermaid diagrams: one copy under `doxia/` instead of the near-identical pages in maven-site-plugin and maven-doxia-sitetools - [ ] Toolchains: maven-toolchains-plugin `toolchains/index`, `jdk`, `custom` and maven-compiler-plugin `compile-using-different-jdk` into `guide-using-toolchains` - [ ] HTTP and deployment: maven-wagon `http-configuration` into `guide-http-settings`; maven-deploy-plugin `deploy-ftp`, `deploy-http`, `deploy-ssh-external`, `deploy-network-issues` into the transport and deployment guides Concepts without a guide yet: - [ ] SCM URLs: maven-scm `scm-url-format`, `scms-overview` and the per-SCM URL sections into the POM reference - [ ] Java targets: maven-compiler-plugin `set-compiler-release`, `set-compiler-source-and-target`, `multirelease` - [ ] Filtering and encoding: maven-resources-plugin `filter`, `escape-filtering`, `encoding` - [ ] APT to Markdown: maven-doxia-converter `migrating-apt-to-markdown` into `doxia/` - [ ] Resolver concepts: maven-resolver `remote-repository-filtering`, `local-repository`, `expected-checksums`, `transporter-known-issues`, `common-misconceptions`, `transitive-dependency-resolution` next to `repositories/` - [ ] Compare and move only where they overlap: maven-plugin-tools `using-annotations` with `guide-java-plugin-development`, maven-invoker-plugin examples with `plugin-developers/plugin-testing`, maven-indexer `how-it-works` with `repository/central-index` Not in scope: generated reference (goal pages, enforcer rules, lifecycle and default-binding pages, the super POM), and component-specific examples. -- 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]
