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

fix: spliting multipass guides #139

Closed

Conversation

CBID2
Copy link
Contributor

@CBID2 CBID2 commented Sep 6, 2024

Description

This PR creates sub how-tos out of "How to set up the driver, creating an easier reading experience for users.

Issue

Closes #111

@giuliazanchi
Copy link
Collaborator

Hi @CBID2 , it looks like you are proposing to split this how-to not only by sub-topic, but also by operating system. For context, we have been merging content that was previously split by OS, using Discourse tabs as a way of showing content conditionally to reduce the number of pages, but also to make it easier for users to see differences at a glance if needed. So, I would not go back to how it was before and create separate pages for Linux, macOS and Windows. I hope this makes sense!

@CBID2
Copy link
Contributor Author

CBID2 commented Sep 9, 2024

Hi @CBID2 , it looks like you are proposing to split this how-to not only by sub-topic, but also by operating system. For context, we have been merging content that was previously split by OS, using Discourse tabs as a way of showing content conditionally to reduce the number of pages, but also to make it easier for users to see differences at a glance if needed. So, I would not go back to how it was before and create separate pages for Linux, macOS and Windows. I hope this makes sense!

Hi @giuliazanchi. I'm still somewhat confused. Are you saying I should separate them only by topic or??

@giuliazanchi
Copy link
Collaborator

Hi @CBID2 , yes, I think identifying smaller topics would be best (and perhaps, while looking at it, catch possible areas of improvement). Another valuable perspective would be motivating why it's good as it is, in terms of topics, and doesn't need to be split. If you like, we can explore ideas in the Documentation room on Matrix. I just posted a message there so you can find me :)

@CBID2 CBID2 closed this Nov 7, 2024
@CBID2 CBID2 deleted the split-content-into-smaller-guides branch November 7, 2024 12:37
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.

Multipass: Split sub how-tos out of "How to set up the driver"
2 participants