Skip to content

Doc: Restructure how-tos, explanation#489

Merged
akcano merged 6 commits into
canonical:mainfrom
akcano:docs/chores
Oct 1, 2025
Merged

Doc: Restructure how-tos, explanation#489
akcano merged 6 commits into
canonical:mainfrom
akcano:docs/chores

Conversation

@akcano
Copy link
Copy Markdown
Contributor

@akcano akcano commented Sep 17, 2025

No description provided.

@akcano akcano requested a review from dmitry-lyfar September 17, 2025 09:09
@akcano akcano self-assigned this Sep 17, 2025
Copy link
Copy Markdown
Collaborator

@dmitry-lyfar dmitry-lyfar left a comment

Choose a reason for hiding this comment

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

I left some notes, but I also think you should reconsider the Hooks explanation's structure. Something feels off here.

Note that we have an intro paragraph on hooks in SDK concepts itself that is very similar to what is written here in the first paragraph. We also have a beautiful https://canonical-workshop--489.com.readthedocs.build/489/reference/sdks/#sdk-hooks that explains the order of execution for hooks.

So the only reason for this to exist is to explain workshopctl and check-health and I'm not sure it's right place for it. Need your help with this.

Comment thread .workshop/starter-pack/hooks/setup-project Outdated
Comment thread docs/explanation/sdks/hooks.rst Outdated
Comment thread docs/explanation/sdks/hooks.rst Outdated
Comment thread docs/explanation/sdks/hooks.rst Outdated
Comment thread docs/explanation/sdks/hooks.rst Outdated
Copy link
Copy Markdown
Collaborator

@dmitry-lyfar dmitry-lyfar left a comment

Choose a reason for hiding this comment

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

This structure is much cleaner.

Comment thread docs/explanation/sdks/concepts.rst Outdated
@akcano akcano merged commit f86c43a into canonical:main Oct 1, 2025
8 of 9 checks passed
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.

2 participants