Skip to content

Clarify documentation according to feedback (infra)#1740

Merged
Hook25 merged 6 commits intomainfrom
clarify_docs
Feb 28, 2025
Merged

Clarify documentation according to feedback (infra)#1740
Hook25 merged 6 commits intomainfrom
clarify_docs

Conversation

@Hook25
Copy link
Copy Markdown
Collaborator

@Hook25 Hook25 commented Feb 19, 2025

Description

There are quite a few aspects of the two new tutorials which were unclear as brought up by a recent hire. This clarifies them all, here is a list:

  • manage.py validate documentated
  • clarify jq dependency may not be there if base is not installed
  • clarify how to get builtin categories and how to create new ones
  • fix wrong dependency of mk-venv
  • Remove outdated ubuntu core page
  • Clarify how to use checkbox on ubuntu core (install checkbox always suggests to use --classic)
  • Mention to disable the agent (!!) pending removal of the automated start
  • submission-cert-automated needs the namespace and base must be installed
  • all commands refer to the com.canonical.certification namespace instead of the one created for the tutorial

Resolved issues

Fixes: CHECKBOX-1741

Documentation

N/A

Tests

N/A

Copy link
Copy Markdown

@artiepoole artiepoole left a comment

Choose a reason for hiding this comment

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

Some additional comments not related to these changes:

  1. Typo spotted on the second note in Writing A Test Plan: test plans ant and test jobs in separate files

  2. In Creating a new provider on "Writing test jobs" page, the 2024 is randomly bold and blue. This could be local settings but a similar thing happens throughout for the id: tags and cd commands

image
image

pieqq
pieqq previously approved these changes Feb 28, 2025
Copy link
Copy Markdown
Collaborator

@pieqq pieqq left a comment

Choose a reason for hiding this comment

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

Just a few suggestions, otherwise good to land! Thanks for updating the docs!

Co-authored-by: Pierre Equoy <pierre.equoy@canonical.com>
@Hook25 Hook25 merged commit 53e0d01 into main Feb 28, 2025
12 of 13 checks passed
@Hook25 Hook25 deleted the clarify_docs branch February 28, 2025 15:35
stanley31huang pushed a commit that referenced this pull request Mar 28, 2025
* Clarify manage validate, jq on base, builtin categories and mk-venv typo

* Clarify how to work on ubuntu core further

Removed very outdated howto as it serves no purpose anymore

* Remember the user to disable the checkbox agent

* Clarify mixed namespacing

* Fixed weird styling, typos and clarified a few phrases

* Apply suggestions from code review

Co-authored-by: Pierre Equoy <pierre.equoy@canonical.com>

---------

Co-authored-by: Pierre Equoy <pierre.equoy@canonical.com>
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.

3 participants