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/)

Alien Bob 06-23-2018 04:16 AM

Quote:

Originally Posted by laxware (Post 5870863)
Okay so the account I made on the docs.slackware.com wiki got deleted, have a good day.

So far, you have created THREE accounts on the Wiki. I enabled the first:

Code:

A new user has registered. Here are the details:

User name : laxware
Full name : ******
E-mail : *******@yahoo.com

Date : 2018/06/22 21:42 (UTC)
Browser : Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:60.0) Gecko/20100101 Firefox/60.0

I deleted the second (it had a slightly different email address, lots of digits in there):
Code:

User name : slaxwareuser
Full name : ******
E-mail : ******@yahoo.com

Date : 2018/06/22 21:44 (UTC)
Browser : Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:60.0) Gecko/20100101 Firefox/60.0

And then you created a third:
Code:

User name : slaxwareuser
Full name : ******
E-mail : ******@yahoo.com

Date : 2018/06/23 01:15 (UTC)
Browser : Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:60.0) Gecko/20100101 Firefox/60.0

This third account is still there, but I have not enabled it (you already have one) and because first I want to learn from this thread what you are trying to accomplish here. The Wiki is a serious documentation project and not a blog. I don't accept articles from someone who thinks spending a few hours in Slackware is sufficient to be able to tell other people how things should be done.

Alien Bob 06-23-2018 04:23 AM

Quote:

Originally Posted by laxware (Post 5870859)
Now from my understanding, the README_CRYPT is not supposed to be a comprehensive howto, it's just supposed to be a decent piece/chunk of some good info/insight and requires background knowledge. That is why I wanted to turn that into a step by step slackware doc howto and also because I want to add a section that goes step by step how to set up early-shh/dropbear so that the drive can be decrypted on boot without a keyboard.

Because it is a TXT document and not a MS Word file or PDF, you think that this README would or should not cover all expects of encrypting your computer? You're wrong there. I wrote that README_CRYPT, long ago, as the source of information for setting up your encrypted Slackware, along with the README-LVM. There should not be a need for more documentation since the user may have nothing at hand except the Slackware DVD he just received from the Slackware Store.

If you think you require background knowledge that is not in the README, and it is not basic Linux or Slackware knowledge you have not yet mastered... show us what's missing and it can be added to the README. That's still the primary place for accurate information.

If you have suggestions to fix the README text, show us textual diffs and don't end up in vague descriptions please. A write-up on early-ssh is not in the scope of that README and would be good material for a Wiki article.

Gerard Lally 06-23-2018 07:59 AM

Quote:

Originally Posted by laxware (Post 5870860)
The simple point is I want to give back, thought a guide/doc would be good. I know for sure I would never have gotten into linux if there weren't forums/ask this ask that websites or tutorials that simply let you copy/paste how to set something up. Initially I had no clue what I was doing but overtime I started to understand better, if that tutorial wasn't there in the first place I would never walked through the doorway though. I am sure when someone is looking for a good server OS Slackware gets mentioned, and if theyre looking to do disk encryption I know I can make a really simple guide, simpler than the ones I see for Debian and hopefully that gets some more people trying out the OS.

Your writing is not up to scratch for Slackware docs.

laxware 06-23-2018 11:26 AM

Quote:

Originally Posted by mralk3 (Post 5870886)
I was a Debian user for some 10 years and switched to Slackware by simply reading the documentation and man pages. You should only really need to read the getting started page on the Slackware documentation project to get up and running. The disk encryption doc by Mr. Pat V. I used with Slackware 14.1 has largely gone unchanged (if at all) for 14.2 and I distinctly remember making it a one and done installation of 14.1 without much reading or difficulty at all.

I take offense to the whole speech about young people not wanting to learn or read because I like to think of myself as the exception to the stereotype of the typical millenial. laxware, you make millenials look bad and have no business working in information technology if you plan to keep that outlook.

Not sure why you are judging my character from posts I am making about an OS question. The truth is difficult to come to terms, still isn't going to stop from enjoying working with linux/operating systems. Millenials make other millenials look bad.

laxware 06-23-2018 11:29 AM

Quote:

Originally Posted by onebuck (Post 5870866)
Hi,
As PV posted in #5 give us some examples. I'm sure PV would accept any useful information.

I have posted some examples earlier and am now playing around with using UUIDs in /etc/crypttab instead of /dev/sda (idk if it will work seems like it does on Ubuntu in the least) to solve the issue that encrypting swap partition has in that it formats itself every boot and shutdown (as it says on the readme). Using the UUIDs would be useful so the wrong partition wont get formatted if someone has a hotswap machine set up and removes a drive or something.

laxware 06-23-2018 11:36 AM

Quote:

Originally Posted by Richard Cranium (Post 5870887)
I'll give @laxware credit for wanting to make other people's lives easier by documenting what he found.

He may decide that it's too big of a PITA for him to do so, but he at least tried.

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.

laxware 06-23-2018 11:46 AM

Quote:

Originally Posted by Alien Bob (Post 5870921)
So far, you have created THREE accounts on the Wiki. I enabled the first:

Code:

A new user has registered. Here are the details:

User name : laxware
Full name : ******
E-mail : *******@yahoo.com

Date : 2018/06/22 21:42 (UTC)
Browser : Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:60.0) Gecko/20100101 Firefox/60.0

I deleted the second (it had a slightly different email address, lots of digits in there):
Code:

User name : slaxwareuser
Full name : ******
E-mail : ******@yahoo.com

Date : 2018/06/22 21:44 (UTC)
Browser : Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:60.0) Gecko/20100101 Firefox/60.0

And then you created a third:
Code:

User name : slaxwareuser
Full name : ******
E-mail : ******@yahoo.com

Date : 2018/06/23 01:15 (UTC)
Browser : Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:60.0) Gecko/20100101 Firefox/60.0

This third account is still there, but I have not enabled it (you already have one) and because first I want to learn from this thread what you are trying to accomplish here. The Wiki is a serious documentation project and not a blog. I don't accept articles from someone who thinks spending a few hours in Slackware is sufficient to be able to tell other people how things should be done.

I don't know what happened with the first account, I think I used an email I no longer had access to so I made a new one with a similar looking email I have, and then I could not log in in there anymore so I made another, I believe.

I have been using Slackware since 2014 (or earlier?)....this is a new LQ account I made, my old one had a bunch of posts asking how to set up web/mail/vsftpd servers under CentOS and when I switched to Slackware I did not even need any assistance except for a few things because the CentOS config files are very close to vanilla like Slackware (unlike Debian/Ubuntu). I forgot the password to that account though so I made a new one. This is also my first time ever setting up disk encryption and I was using the README_CRYPT file but I ran into a lot of errors where the solutions were fragmented on LQ and not in one central place.

That is basically what I want to do with the slackware doc I wish to make, as well as add a portion for being able to decrypt the drive on a headless machine. I have already successfully done it on my machine so it works. Another user helped me/did all of the work for that but it still fragmented in yet another LQ thread.

laxware 06-23-2018 11:52 AM

Quote:

Originally Posted by Gerard Lally (Post 5870945)
Your writing is not up to scratch for Slackware docs.

You can't base my writing skills off of a thread post, I write these quickly and then sometime make some edits to them. Why are you guys so rude here? This has turned into a whole thing just because I had a question because I could not figure out how to navigate the UI of the docs wiki. I guess now one of you will quote that portion and say if I can't figure it out myself I shouldn't be writing it. Come on.

Alien Bob 06-23-2018 11:59 AM

Quote:

Originally Posted by laxware (Post 5871009)
I don't know what happened with the first account, I think I used an email I no longer had access to so I made a new one with a similar looking email I have, and then I could not log in in there anymore so I made another, I believe.

I have been using Slackware since 2014 (or earlier?)....this is a new LQ account I made, my old one had a bunch of posts asking how to set up web/mail/vsftpd servers under CentOS and when I switched to Slackware I did not even need any assistance except for a few things because the CentOS config files are very close to vanilla like Slackware (unlike Debian/Ubuntu). I forgot the password to that account though so I made a new one. This is also my first time ever setting up disk encryption and I was using the README_CRYPT file but I ran into a lot of errors where the solutions were fragmented on LQ and not in one central place.

That is basically what I want to do with the slackware doc I wish to make, as well as add a portion for being able to decrypt the drive on a headless machine. I have already successfully done it on my machine so it works. Another user helped me/did all of the work for that but it still fragmented in yet another LQ thread.

I've reset the password for your first account and changed the email address it uses to the one you entered for the second and third account. You should soon have an email with the password.

laxware 06-23-2018 12:12 PM

Quote:

Originally Posted by Alien Bob (Post 5871016)
I've reset the password for your first account and changed the email address it uses to the one you entered for the second and third account. You should soon have an email with the password.

Okay thank you, do you think for the time being I should post the doc to https://www.linuxquestions.org/quest...ss-stories-23/ (as a member mentioned) see how the feedback goes and then think about writing it on a doc at a later time?

Alien Bob 06-23-2018 12:15 PM

I think you should post a diff to the original Slackware README and the README you modified according to your adventures. That is what I would consider the most relevant information.
Then you can post a personal story on LQ if you want, and polish that so that its quality is worthy of the Wiki.

onebuck 06-23-2018 12:25 PM

Member response
 
Hi,

Quote:

Originally Posted by laxware (Post 5871011)
You can't base my writing skills off of a thread post, I write these quickly and then sometime make some edits to them. Why are you guys so rude here? This has turned into a whole thing just because I had a question because I could not figure out how to navigate the UI of the docs wiki. I guess now one of you will quote that portion and say if I can't figure it out myself I shouldn't be writing it. Come on.

I see no rudeness but direct statements. No personal attacks either. You seem to have thin skin. You might need to thicken up a bit. If you do write something related to the topic. Expect feedback! No hand holding, just direct comments. As to your navigation skills then you should learn to use doc page search.

Maybe you should look at https://www.linuxquestions.org/quest...#faq_lqwelcome so you can compose a proper post/query.

You were rude to me when you quote my post to you but strike through your reply. That type of habit/etiquette will not make you many friends here.

Your reading or viewing doc page is on you. If you had read the page you would/should have found the proper methods. https://docs.slackware.com/start is an easy format and layout. You could have done a search on that page to get to something you may have over looked. You do know how to search? Search is just under the navigation set on the left bar.
Quote:

Anger is a momentary madness, so control your passions or it will control you.” -Horace
Hope this helps.
Have fun & enjoy!
:hattip:

khronosschoty 06-23-2018 12:47 PM

I just wanted to give some words of encouragement. Do not be discouraged. Your attempt / desire to contribute is a good one. Consider the feed back, and slight friction you are experiencing, encouraging.

Gerard Lally 06-23-2018 02:17 PM

Quote:

Originally Posted by laxware (Post 5871011)
You can't base my writing skills off of a thread post, I write these quickly and then sometime make some edits to them. Why are you guys so rude here? This has turned into a whole thing just because I had a question because I could not figure out how to navigate the UI of the docs wiki. I guess now one of you will quote that portion and say if I can't figure it out myself I shouldn't be writing it. Come on.

Technical writing should be tightly focused. Your writing is rambling. I'm not being rude by telling you that. Before you were born I had been an English tutor at a west of Ireland university for years. Students expected me to critique their writing, not to give them a shoulder to cry on. Besides, you were exceptionally rude in your OP, by insulting those far older and more experienced than you. I really dislike that attitude among your age group.

laxware 06-23-2018 03:13 PM

Quote:

Originally Posted by Gerard Lally (Post 5871062)
Technical writing should be tightly focused. Your writing is rambling. I'm not being rude by telling you that. Before you were born I had been an English tutor at a west of Ireland university for years. Students expected me to critique their writing, not to give them a shoulder to cry on. Besides, you were exceptionally rude in your OP, by insulting those far older and more experienced than you. I really dislike that attitude among your age group.

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


All times are GMT -5. The time now is 12:10 PM.