Skip to content

Conversation

@erinecon
Copy link
Contributor

@erinecon erinecon commented Jul 14, 2025

Incorporate feedback from UX sessions into the 12-factor tutorials.

Summary of changes

  • cat rockcraft.yaml and update the architecture
  • when updating the version, show a snippet of rockcraft.yaml to make it explicit
  • Intro to the initial Rockcraft section explaining a rock better
  • Make Multipass much more mandatory in the language
  • More explanation in the setup section – copied over the text about Rockcraft
  • Add the $(dpkg --print-architecture)where applicable to make the commands accessible to all architectures
  • Emphasize-lines in code blocks where appropriate (didn’t see anything)
  • Moved the LXD/Docker warning to the first pack attempt, and added another potential clue in the output
  • Improved product terminology (removed code formatting for npm and go instances, converted some of the profile mentions to plain text, updated the Spring Boot tutorial title in the navigational menu)
  • Have you followed the guidelines for contributing?
  • Have you signed the CLA?
  • Have you successfully run make lint && make test?

Successfully ran make lint-docs

Copy link
Contributor

@medubelko medubelko left a comment

Choose a reason for hiding this comment

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

Looks good, left some smallish suggestions.

@erinecon erinecon marked this pull request as ready for review July 15, 2025 19:23
@erinecon erinecon requested a review from tigarmo as a code owner July 15, 2025 19:23
@erinecon erinecon requested a review from medubelko July 15, 2025 19:23
@medubelko medubelko requested a review from bepri July 16, 2025 01:11
Copy link
Contributor

@medubelko medubelko left a comment

Choose a reason for hiding this comment

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

Changes LGTM. Waiting on a possible fix for last two intertwined comments.

Copy link
Contributor

@medubelko medubelko left a comment

Choose a reason for hiding this comment

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

@erinecon Those fixes LGTM.

Copy link
Collaborator

@tigarmo tigarmo 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'll merge these once the tests finish

@tigarmo tigarmo merged commit ddb5bbb into canonical:main Jul 23, 2025
17 of 18 checks passed
@erinecon erinecon deleted the 12f-tutorials-ux-feedback branch August 1, 2025 13:22
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.

5 participants