Conversation
Changing the 3 column layout to 2 column as per conversation in Slack with @jackgibson1 https://cloudsmith-io.slack.com/archives/C03RCPME8J3/p1772455542446799?thread_ts=1772452606.221399&cid=C03RCPME8J3 Needs a review to make sure the information is still correct
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
There was a problem hiding this comment.
Pull request overview
Updates the Custom domains documentation to simplify the package support matrix from a 3-column (Download / Native Uploads / Native Downloads) layout to a 2-column (Download / Native support) layout.
Changes:
- Replaces the 4-column package support table with a 3-column table (collapsing native upload/download into “Native support”).
- Updates per-package entries in the table to reflect the new schema.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| | Cargo (Rust) | ✅ | ❌ | | ||
| | Chocolatey | - | ✅ | | ||
| | Cocoapods | ✅ | ❌ | | ||
| | Composer | ✅ | ❌ | | ||
| | Conan | - | ✅ | | ||
| | Conda | ✅ | ❌ | | ||
| | CRAN | ✅ | ❌ | | ||
| | Dart | - | ✅ | | ||
| | Debian | ✅ | ❌ | | ||
| | Docker | - | ✅ | | ||
| | Go | ✅ | ❌ | |
There was a problem hiding this comment.
The new "Native support" column contradicts the doc text above: formats called out as API-based/native (e.g., Cargo and Conan) are marked ❌ here. If "Native support" means “uses native API domains”, these rows should be ✅ (or otherwise rename/clarify the column to match the intended meaning).
| | Cargo (Rust) | ✅ | ❌ | | |
| | Chocolatey | - | ✅ | | |
| | Cocoapods | ✅ | ❌ | | |
| | Composer | ✅ | ❌ | | |
| | Conan | - | ✅ | | |
| | Conda | ✅ | ❌ | | |
| | CRAN | ✅ | ❌ | | |
| | Dart | - | ✅ | | |
| | Debian | ✅ | ❌ | | |
| | Docker | - | ✅ | | |
| | Go | ✅ | ❌ | | |
| | Cargo (Rust) | ✅ | ✅ | | |
| | Chocolatey | - | ✅ | | |
| | Cocoapods | ✅ | ❌ | | |
| | Composer | ✅ | ❌ | | |
| | Conan | - | ✅ | | |
| | Conda | ✅ | ✅ | | |
| | CRAN | ✅ | ❌ | | |
| | Dart | - | ✅ | | |
| | Debian | ✅ | ❌ | | |
| | Docker | - | ✅ | | |
| | Go | ✅ | ✅ | |
| | Docker | - | ✅ | | ||
| | Go | ✅ | ❌ | | ||
| | Gradle | ✅ | ❌ | | ||
| | Helm | ✅ | ❌ | | ||
| | Hex | - | ✅ | |
There was a problem hiding this comment.
Several API-based formats appear to be incorrectly marked as lacking native support (e.g., Docker/Go/Gradle/Hex). Please update these values (or adjust the column definition) so the table matches the behavior described in the “API-based (Native) package formats” paragraph above.
| | NuGet | - | ✅ | | ||
| | PowerShell | - | ✅ | | ||
| | Python | ✅ | ❌ | | ||
| | Raw | ✅ | ❌ | |
There was a problem hiding this comment.
More API-based formats are marked as not having native support (npm/NuGet/PowerShell/Python), which conflicts with the earlier description. Also, "Raw" previously had “not applicable” for native; consider using “-” (or another explicit N/A marker) rather than ❌ if native domains don’t apply to that package type.
| | Raw | ✅ | ❌ | | |
| | Raw | ✅ | - | |
| | RPM | ✅ | ❌ | | ||
| | Ruby | - | ✅ | | ||
| | sbt | ✅ | ❌ | | ||
| | Swift | ✅ | ❌| |
There was a problem hiding this comment.
Table row formatting is inconsistent here (missing space before the trailing pipe). Please normalize spacing so markdown table rendering is consistent across rows.
There was a problem hiding this comment.
Swift has it's own API
There was a problem hiding this comment.
Fixed spacing and adding ✅ for Native API column
| | Package Type | Download | Native support | | ||
| |:--- |:--- |:--- | | ||
| | Alpine | ✅ | ❌ | | ||
| | Cargo (Rust) | ✅ | ❌ | |
There was a problem hiding this comment.
Cargo has it's own Native API
There was a problem hiding this comment.
Updated Native API column to ✅ for Cargo
| | Cocoapods | ✅ | ❌ | | ||
| | Composer | ✅ | ❌ | | ||
| | Conan | - | ✅ | | ||
| | Conda | ✅ | ❌ | |
There was a problem hiding this comment.
Conda has it's own Native API
There was a problem hiding this comment.
Updated Conda Native API column to ✅
| | Dart | - | ✅ | | ||
| | Debian | ✅ | ❌ | | ||
| | Docker | - | ✅ | | ||
| | Go | ✅ | ❌ | |
There was a problem hiding this comment.
Go has it's own Native API
There was a problem hiding this comment.
Updated Go Native API to ✅
| | Helm | ✅ | ❌ | | ||
| | Hex | - | ✅ | | ||
| | LuaRocks | ✅ | ❌ | | ||
| | Maven | ✅ | ❌ | |
There was a problem hiding this comment.
Technically Maven has it's own native API too (which uploads occur on). Downloads are redirected to the DL domain from it too.
There was a problem hiding this comment.
I think with this one, if the way we set up the Custom Domains will differ to the rest of the formats with Native API support we should avoid labelling as such, even if it's technically supported.
Native API support being termed that a customer could set up both Upload and Download routes
| | RPM | ✅ | ❌ | | ||
| | Ruby | - | ✅ | | ||
| | sbt | ✅ | ❌ | | ||
| | Swift | ✅ | ❌| |
There was a problem hiding this comment.
Swift has it's own API
| | Ruby | - | ✅ | | ||
| | sbt | ✅ | ❌ | | ||
| | Swift | ✅ | ❌| | ||
| | Terraform | ✅ | ❌ | |
There was a problem hiding this comment.
Terraform has it's own API
There was a problem hiding this comment.
Updated Swift and Terraform Native API support to ✅
| | Cargo (Rust) | ✅ | ❌ | | ||
| | Chocolatey | - | ✅ | | ||
| | Cocoapods | ✅ | ❌ | | ||
| | Composer | ✅ | ❌ | |
There was a problem hiding this comment.
Composer now has it's own Native API
There was a problem hiding this comment.
Updated Composer Native API support to ✅
Updated as per @jackgibson1 's feedback
|
For easier readability, perhaps we should change the table slightly to something like this:
|
|
Once this change goes in, we should also ensure that https://help.cloudsmith.io/docs/custom-domains is updated too - I can see both have different contents which might be a bit misleading. |
Changing the 3 column layout to 2 column as per conversation in Slack with @jackgibson1
https://cloudsmith-io.slack.com/archives/C03RCPME8J3/p1772455542446799?thread_ts=1772452606.221399&cid=C03RCPME8J3
Needs a review to make sure the information is still correct