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

Netplan: Add guidance on setting up how-to environment #106

Open
rkratky opened this issue Jun 21, 2024 · 2 comments
Open

Netplan: Add guidance on setting up how-to environment #106

rkratky opened this issue Jun 21, 2024 · 2 comments
Assignees
Labels
help wanted We welcome community help with this issue how-to Create a edit a how-to to achieve a specific task new Adding new or missing documentation for a specific tool, feature, or function. size 3 Fix a known documentation issue (size 3/8)

Comments

@rkratky
Copy link
Collaborator

rkratky commented Jun 21, 2024

Context

Three of the how-to guides for Netplan feature very similar scenarios, and all of them start with the user having to configure their environment in a specific way. These are the how-tos:

In the beginning of each how-to, the user is asked to set up their networking, but specific instructions on how to perform such set up are missing.

Task

Either develop the content (instructions) on how to set up the environment at the beginning of each how-to and include it in the how-tos, or find suitable instructions in other docs and link to them (such as in existing Netplan how-tos).

Given there are a number of things that need to be set up, it's perfectly fine to provide instructions just for one or more of those -- you don't need to worry about not describing every single detail of the setup. Any improvement is worth it.

Note: It is rather probable that the same instructions on environment setup will apply to all three of the how-tos (or just with minor adjustments).

Reference

@rkratky rkratky added new Adding new or missing documentation for a specific tool, feature, or function. help wanted We welcome community help with this issue size 3 Fix a known documentation issue (size 3/8) how-to Create a edit a how-to to achieve a specific task labels Jun 21, 2024
@renukashiwakoti
Copy link

Hello @rkratky,

I'm interested in working on this task. If it's still available, could you please assign it to me?

Thank you!

@rkratky
Copy link
Collaborator Author

rkratky commented Jul 23, 2024

Sure thing! Thank you for picking this up, @renukashiwakoti. Let me know if you need anything.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
help wanted We welcome community help with this issue how-to Create a edit a how-to to achieve a specific task new Adding new or missing documentation for a specific tool, feature, or function. size 3 Fix a known documentation issue (size 3/8)
Projects
None yet
Development

No branches or pull requests

2 participants