feat(ENG-9724): update generic docs

[poconnor-cloud]

Add docs outlining our support for Generic format

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Review	Updated (UTC)
cloudsmith-docs	Ready	Preview, Comment	Jan 27, 2026 9:22am

[Copilot]

Pull request overview

This PR adds comprehensive documentation for Cloudsmith's Generic format support, enabling users to store and manage arbitrary files using path-based identification.

Changes:

• Added new Generic format documentation covering upload, download, HTML/JSON indexing, upstream proxying, and GPG signing
• Added Generic menu entry in the documentation navigation (correctly positioned alphabetically between Docker and Go)
• Cleaned up trailing whitespace in menu.json for improved code quality

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File	Description
src/content/menu.json	Added Generic format menu entry and removed trailing whitespace throughout the file
src/content/formats/generic-repository.mdx	New comprehensive documentation for Generic format including CLI/web upload, public/private download instructions, HTML/JSON indexing, upstream proxying configurations, and GPG signing support

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[poconnor-cloud]

Just need to update the upstreams/index and should be good to go

[apoclyps]

Example of what we added for the HuggingFace Format & Conda upstreams when they were added as new that we can use to check we include everything necessary:

• add(format): hugging face #220
• Conda upstreams #244

[poconnor-cloud]

Updated the above with a screenshot from the new web-ui @apoclyps

[paulmay-cloudsmith]

Hey there; could this text be moved up to just after the heading, used as an introduction?

Generic upstreams work with simple HTML-based sources. The upstream must consist of simple, unstyled HTML pages with no JavaScript. Each page should contain only links to package files or subdirectories. Examples include Gradle distributions, Apache releases, and Node distributions.