Skip to content

docs: document MavenPackage content type - #438

Merged
dkliban merged 1 commit into
pulp:mainfrom
carlosthe19916:docs/pulp-2073-mavenpackage
Aug 19, 2026
Merged

docs: document MavenPackage content type#438
dkliban merged 1 commit into
pulp:mainfrom
carlosthe19916:docs/pulp-2073-mavenpackage

Conversation

@carlosthe19916

Copy link
Copy Markdown
Contributor

Summary

Adds a user-facing guide for the MavenPackage content type at
docs/user/guides/packages.md. The content type itself was already implemented
and released (0.25.0); this PR fills the documentation gap.

The guide covers:

  • What a Maven package is (a GAV-level unit grouping the individual MavenArtifact files)
  • How packages are created automatically from a POM (upload and mvn deploy), plus the pull-through cache behavior
  • The metadata extracted from the POM (name, description, packaging, url, licenses, dependencies, scm_url)
  • Release vs -SNAPSHOT behavior (releases fixed; snapshots refreshed on each POM)
  • The read-only REST API for browsing/filtering packages
  • The one-time upgrade backfill

Ticket

Fixes https://redhat.atlassian.net/browse/PULP-2073

Notes

Documentation-only change — no code, migration, or behavior changes. No changelog
entry is included as this is a pure-docs change and the feature was already noted in
CHANGES/2072.feature.

🤖 Generated with Claude Code

Add a user guide for the MavenPackage content type covering what a package
is, how it is created from a POM (upload and deploy), the metadata extracted
from the POM, release vs -SNAPSHOT behavior, the read-only REST API for
browsing/filtering packages, and the upgrade backfill.

Ref: https://redhat.atlassian.net/browse/PULP-2073

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@dkliban
dkliban force-pushed the docs/pulp-2073-mavenpackage branch from df29847 to ac0cba2 Compare August 19, 2026 13:00
@dkliban
dkliban merged commit 06d8cdc into pulp:main Aug 19, 2026
11 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants