Skip to content

docs: add a how-to guide about publishing a charm#2420

Merged
dwilding merged 12 commits intocanonical:mainfrom
dwilding:how-to-publish
Apr 29, 2026
Merged

docs: add a how-to guide about publishing a charm#2420
dwilding merged 12 commits intocanonical:mainfrom
dwilding:how-to-publish

Conversation

@dwilding
Copy link
Copy Markdown
Contributor

@dwilding dwilding commented Apr 11, 2026

This PR adds a how-to guide to fill a gap in the Ops docs: We talk about how make a charm discoverable on Charmhub, but not how to publish to Charmhub in the first place. I want to make sure that our homepage and how-to guides have a clear entrypoint for this topic, even if we are linking out to Charmcraft for the specifics about how to publish.

Preview of new doc

@dwilding dwilding marked this pull request as ready for review April 13, 2026 03:56
@dwilding
Copy link
Copy Markdown
Contributor Author

FYI @jahn-junior, I want to make sure you've seen this new Ops doc before we publish it. Please let me know if you have any suggestions - thanks!

Comment thread docs/howto/publish-your-charm-on-charmhub.md Outdated
Comment thread docs/howto/publish-your-charm-on-charmhub.md Outdated
Copy link
Copy Markdown
Collaborator

@tonyandrewmeyer tonyandrewmeyer left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks! I think this will definitely help make the site be a more complete picture of charming, and make it easier to figure out how to publish without having to search in a lot of places.

A few suggestions, but happy to approve in advance.

Comment thread docs/howto/publish-your-charm-on-charmhub.md Outdated
Comment thread docs/howto/publish-your-charm-on-charmhub.md Outdated
Comment thread docs/howto/publish-your-charm-on-charmhub.md Outdated
Comment thread docs/howto/publish-your-charm-on-charmhub.md Outdated
@dwilding dwilding requested a review from tromai April 29, 2026 03:53
@dwilding
Copy link
Copy Markdown
Contributor Author

@tromai would you mind reviewing this when you get time? I need one more reviewer and I would especially like to know whether the explanations of tracks and channels are helpful for someone who might be newer to this stuff!

@tromai
Copy link
Copy Markdown

tromai commented Apr 29, 2026

@tromai would you mind reviewing this when you get time? I need one more reviewer and I would especially like to know whether the explanations of tracks and channels are helpful for someone who might be newer to this stuff!

Absolutely, I will have a look into it.

Copy link
Copy Markdown

@tromai tromai left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the update.
Everything looks great to me. I really like how the publish step is separated from making the charm discoverable.
I have a comment in publish-your-charm-on-charmhub.md, and am happy to approve the PR after it is resolved.

Comment thread docs/howto/publish-your-charm-on-charmhub.md Outdated
@dwilding dwilding merged commit bdf2a6e into canonical:main Apr 29, 2026
59 checks passed
@dwilding dwilding deleted the how-to-publish branch April 29, 2026 07:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants