Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add device ownership configuration docs again #770

Merged
merged 3 commits into from
Jan 30, 2025
Merged

Conversation

adombeck
Copy link
Contributor

The documentation of the device ownership configuration was revert in #704 because back then we didn't have a latest version of the docs, so the documentation was already live but the feature was not released yet, which led to confusion of users.

I cherry-picked 4ed5bd4, but the "Broker configuration" section which that commit added the new documentation to doesn't exist anymore since 872c99a2797b0333cb228ef2316e3c69abfdd1c, so I added it to a new "Configure allowed users" section instead. 4ed5bd4 added the full content of the broker.conf file to the "Broker configuration" section, which also included the home_base_dir and ssh_allowed_suffixes options along with their comments, so those were documented to some degree as a side effect. I did not add those to the new "Configure allowed users" section, so they are now still not documented.

@adombeck adombeck requested a review from a team as a code owner January 29, 2025 14:18
@adombeck adombeck requested a review from edibotopic January 29, 2025 14:18
@adombeck
Copy link
Contributor Author

@edibotopic Feel free to take over this PR and restructure, rephrase or rewrite as you see fit.

@adombeck adombeck force-pushed the device-ownership-doc branch from 06ca4be to 739c5af Compare January 29, 2025 14:24
Copy link
Contributor

@edibotopic edibotopic left a comment

Choose a reason for hiding this comment

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

This looks fine to me @adombeck .
I just have a minor change and a tiny query.

Approving in advance. If the docs are restructured in an upcoming pulse then the placement of this specific content can be reappraised as needed.

docs/howto/configure-authd.md Outdated Show resolved Hide resolved
docs/howto/configure-authd.md Outdated Show resolved Hide resolved
docs/howto/configure-authd.md Show resolved Hide resolved
@adombeck
Copy link
Contributor Author

Reading this new section, it feels like it's only repeating what is already documented in the comments of the [users] config section. Maybe this can be improved in the upcoming restructuring.

@adombeck adombeck force-pushed the device-ownership-doc branch from a38a568 to 304e661 Compare January 29, 2025 20:29
@edibotopic edibotopic merged commit 6cc9f93 into main Jan 30, 2025
16 checks passed
@edibotopic edibotopic deleted the device-ownership-doc branch January 30, 2025 11:24
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