LinuxQuestions.org

LinuxQuestions.org (/questions/)
-   Slackware (https://www.linuxquestions.org/questions/slackware-14/)
-   -   How can one contribute to docs.slackware.com ? (https://www.linuxquestions.org/questions/slackware-14/how-can-one-contribute-to-docs-slackware-com-4175632496/)

Gerard Lally 06-23-2018 03:17 PM

Quote:

Originally Posted by laxware (Post 5871085)
When I write on here it is rambling but if I write a doc I will for sure change the writing style. Its the equivalent of having a casual conversation vs writing a company email. Thanks

Go ahead and do it then. Good luck.

Alien Bob 06-23-2018 04:08 PM

Quote:

Originally Posted by laxware (Post 5870854)
This is the front page, https://docs.slackware.com/start and your link https://docs.slackware.com/slackdocs:styleguide is on the side of the guide. Not to mention I found the contributing guide through a google search and it did not mention those. It is not really easy to find.

All that information including the 'contributing' link you mention in your first post is available on the front page of the Wiki. You just need to look.

Richard Cranium 06-23-2018 09:08 PM

Quote:

Originally Posted by laxware (Post 5871005)
If I dedicate every free amount of time I have no doubt, but I did not want to spend a lot of time figuring out how to navigate the UI of the docs wiki simply because of time constraints. If I google search "Arch wiki contributing" I get this first link https://wiki.archlinux.org/index.php...i:Contributing and off the bat I am informed of the etiquette, just like slackdocs. However, if I keep scrolling I am actually told how to start a new page under "Creating". That info is not existent on the slackdocs contributing page, moreso that it gives info about editing existing docs and not making your own, so I went on here to ask for some additional info and I get treated with a "Really. Can't you just read the front page of the Wiki first? This thread is a waste." because I did not spend 2-3 hours looking over the entire page. I respond and the blame is still on me, I am from the "outside" so to speak coming into your "bubble" so I know how it goes. We can all just try and be a bit realistic though.

Yeah, weird. I scroll down the very first page (https://docs.slackware.com/start) and see (links removed via cut-and-paste)...
Quote:

If you are willing and able to contribute to the wiki, please see this list for ideas. Perhaps you already have an idea for a new article!
We understand that you may be uncertain about your writing skills or unsure about how to start contributing. If that is the case, we encourage you to subscribe to the mailing list and ask for help. The people on that list will certainly offer assistance.
If you think that a mailing list is difficult to use, we wrote helpful instructions for you.
Odd, isn't it? A project that isn't Arch does things differently than Arch. I may read a lot faster than you do (if English isn't your native tongue, it could take you a lot longer to scan the page than it took me), but we're talking seconds to find that text.

Like I wrote, you may decide that it is a bigger PITA to contribute than you wish to experience. That's fine.

What to do is documented, even if you don't want to do what it tells you to do. I cannot tell you the best way to use your spare time; you're only going to live so long and every second you spend doing something you don't really want to do is a second that you're never going to get back.

captain_sensible 11-04-2019 06:03 AM

general consensus and unification of site a place to go for docs?
 
moved to to a more relevant thread


All times are GMT -5. The time now is 02:43 PM.