Closed lafrenierejm closed 1 month ago
lafrenierejm
commented
1 month ago 
morrownr
commented
1 month ago 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
commented
1 month ago 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
commented
1 month ago 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
commented
1 month ago …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.
:100:
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
commented
1 month ago 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