Restructure "USB WiFi adapter information for Linux"

[lafrenierejm]

• Paragraphs are broken up into one sentence per line to make future diffs smaller and easier to read. This does not change how the text is rendered in visitors' web browsers. See a rendered version here.
• I added several additional subheadings to improve navigation and readability.

[morrownr]

Merged. Do you have any interest in being a partner on this site? So much more could be done and most of my time right now is working with a small group to get more drivers in the kernel.

[lafrenierejm]

Merged. Do you have any interest in being a partner on this site? So much more could be done and most of my time right now is working with a small group to get more drivers in the kernel.

Yes, I would be glad to help maintain these docs!

[morrownr]

Great! Let's take it one step at a time and see where we end up. I'm getting up there in years so really need to have a backup in case something happens to me.

I like what you are doing now but I have one request: Since you obviously know how to make a PR, would you mind making a guide on how to make PR's for users of this site. It needs to be step by step and it should be for folks that really have little knowledge of git. The reason I make this request is that many many people use this site and have information that can be added or corrections that can be made but they don't do because they don't know how to do it in a way that does not take a lot of back and forth with me. This site is about information and the easier it is for users to help maintain the site, the better it can be.

Eventually I will look at giving admin rights if you see that this is something you are interesting in doing.

@morrownr

[lafrenierejm]

…would you mind making a guide on how to make PR's for users of this site. It needs to be step by step and it should be for folks that really have little knowledge of git.

Yeah, I can definitely put together a guide for prospective contributors!

The reason I make this request is that many many people use this site and have information that can be added or corrections that can be made but they don't do because they don't know how to do it in a way that does not take a lot of back and forth with me.

Are there any historical PRs you could link me to that exemplify the sorts of issues contributors often have encountered? Having a clearer idea of exactly what people have struggled with in the past would help ensure a contributor guide properly addresses them.

This site is about information and the easier it is for users to help maintain the site, the better it can be.

💯

Eventually I will look at giving admin rights if you see that this is something you are interesting in doing.

That's potentially something I'd be interested in long-term. But for the time being, I agree with your "one step at a time" approach.

[morrownr]

Are there any historical PRs you could link me to that exemplify the sorts of issues contributors often have encountered?

Let me walk you through a couple of examples:

User needs a driver.
Searches the internet.
Comes directly to one of the repos here. Let's say it is: https://github.com/morrownr/8812au-20210820
Use reads the README and installs.
User has seen the section called Tested Linux Distributions.
He/she wants to update something or add something.

User is at the repo in a browser. What steps should be taken to allow the user to submit a PR?

And the same goes any of the documents in the Main Menu, such as what you have been doing.

Doesn't have to be perfect at first and we can test it and then we will see where users have problems and it can be improved.

@morrownr