LinuxQuestions.org
Latest LQ Deal: Latest LQ Deals
Go Back   LinuxQuestions.org > Forums > Linux Forums > Linux - Distributions > Slackware
User Name
Password
Slackware This Forum is for the discussion of Slackware Linux.

Notices


Reply
  Search this Thread
Old 06-22-2018, 05:49 PM   #1
laxware
Member
 
Registered: Jun 2018
Posts: 45

Rep: Reputation: Disabled
How can one contribute to docs.slackware.com ?


First off, the login page is not using HTTPS?

Anyway, how can one start making a page on the docs? I am not very familiar with the settings/UI and do not want to spend a lot of time figuring it out. I have read this https://docs.slackware.com/slackdocs:contributing but can't seem to find how I actually contribute something.

I see there is a lettering format under the HOWTOs, I want to basically title it "Encrypting root partition with LUKS" so that should go under E ?

Last edited by laxware; 06-22-2018 at 05:52 PM.
 
Old 06-22-2018, 06:10 PM   #2
onebuck
Moderator
 
Registered: Jan 2005
Location: Summer Midwest USA, Central Illinois, Winter Central Florida
Distribution: Slackware«
Posts: 13,449
Blog Entries: 32

Rep: Reputation: 2632Reputation: 2632Reputation: 2632Reputation: 2632Reputation: 2632Reputation: 2632Reputation: 2632Reputation: 2632Reputation: 2632Reputation: 2632Reputation: 2632
Member response

Hi,

Welcome to LQ & Slackware.

Register as a new user

You did read; authoring tutorial
& Slackdocs Style guide.

Hope this helps.
Have fun & enjoy!
 
Old 06-22-2018, 06:10 PM   #3
Alien Bob
Slackware Contributor
 
Registered: Sep 2005
Location: Eindhoven, The Netherlands
Distribution: Slackware
Posts: 7,731

Rep: Reputation: 6296Reputation: 6296Reputation: 6296Reputation: 6296Reputation: 6296Reputation: 6296Reputation: 6296Reputation: 6296Reputation: 6296Reputation: 6296Reputation: 6296
Really. Can't you just read the front page of the Wiki first? This thread is a waste. Taking it off the zero-reply list. Then read the introduction texts.
I will accept an article that's factually correct. Good luck.
So far you've only shown that perhaps you should first read and learn some more about Slackware and its inner workings as your priority?
 
Old 06-22-2018, 08:40 PM   #4
laxware
Member
 
Registered: Jun 2018
Posts: 45

Original Poster
Rep: Reputation: Disabled
Quote:
Originally Posted by Alien Bob View Post
Really. Can't you just read the front page of the Wiki first? This thread is a waste. Taking it off the zero-reply list. Then read the introduction texts.
I will accept an article that's factually correct. Good luck.
So far you've only shown that perhaps you should first read and learn some more about Slackware and its inner workings as your priority?
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. You have to understand not everyone has your level of expertise, I understand Slackware is a bit of a niche distro but I don't see how you can expect someone to devote every minute of their free time looking extensively at everything. Getting to understand and "play around" with Slackware already takes out hours of someone's time, then speculating every single aspect of the docs wiki is another. I don't know anyone personally who would be anywhere near close to what I am doing, the people who use Linux are already a small bunch, the people who use Slackware are even smaller, cut me some slack. I like the distro and want to contribute in some way, I may just post a guide here on LQ but I wanted to put it on the docs to ensure it maintains longevity and it makes the OS feel a bit more polished.

The guide that I want to make is basically a snippet/adaptation of the README_Crypt that points out some of its outdatedness (some of the stuff the README says no longer works anymore). I have figured out what you have to do and it works well enough to be replicated and I think is useful to other people. I know if someone else already made a guide like that I would have had LUKS encryption set up very quickly. Again...you can't expect me to learn the 100% inner workings of the system just to post a guide on doing a particular part. Linux is really useful and to get people to use it requires to make some tutorials/howtos. I set up my own VPN on linux because of a tutorial that was available, I understand the basics and as time goes I understand a bit more, if it were not for that tutorial I would have settled for some crappy proprietary VPN software server/client combo with GUIs on Windows and would understand even less about what I was doing.

Last edited by laxware; 06-22-2018 at 08:44 PM.
 
2 members found this post helpful.
Old 06-22-2018, 08:49 PM   #5
volkerdi
Slackware Maintainer
 
Registered: Dec 2002
Location: Minnesota
Distribution: Slackware! :-)
Posts: 1,787

Rep: Reputation: 5724Reputation: 5724Reputation: 5724Reputation: 5724Reputation: 5724Reputation: 5724Reputation: 5724Reputation: 5724Reputation: 5724Reputation: 5724Reputation: 5724
Quote:
Originally Posted by laxware View Post
The guide that I want to make is basically a snippet/adaptation of the README_Crypt that points out some of its outdatedness (some of the stuff the README says no longer works anymore).
Such as... ?
 
1 members found this post helpful.
Old 06-22-2018, 08:52 PM   #6
Gerard Lally
Senior Member
 
Registered: Sep 2009
Location: Br˙ na Bˇinne, IE
Distribution: Slackware, NetBSD
Posts: 1,635

Rep: Reputation: 1121Reputation: 1121Reputation: 1121Reputation: 1121Reputation: 1121Reputation: 1121Reputation: 1121Reputation: 1121Reputation: 1121
Quote:
Originally Posted by laxware View Post
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. You have to understand not everyone has your level of expertise, I understand Slackware is a bit of a niche distro but I don't see how you can expect someone to devote every minute of their free time looking extensively at everything. Getting to understand and "play around" with Slackware already takes out hours of someone's time, then speculating every single aspect of the docs wiki is another. I don't know anyone personally who would be anywhere near close to what I am doing, the people who use Linux are already a small bunch, the people who use Slackware are even smaller, cut me some slack. I like the distro and want to contribute in some way, I may just post a guide here on LQ but I wanted to put it on the docs to ensure it maintains longevity and it makes the OS feel a bit more polished.

The guide that I want to make is basically a snippet/adaptation of the README_Crypt that points out some of its outdatedness (some of the stuff the README says no longer works anymore). I have figured out what you have to do and it works well enough to be replicated and I think is useful to other people. I know if someone else already made a guide like that I would have had LUKS encryption set up very quickly. Again...you can't expect me to learn the 100% inner workings of the system just to post a guide on doing a particular part. Linux is really useful and to get people to use it requires to make some tutorials/howtos. I set up my own VPN on linux because of a tutorial that was available, I understand the basics and as time goes I understand a bit more, if it were not for that tutorial I would have settled for some crappy proprietary VPN software server/client combo with GUIs on Windows and would understand even less about what I was doing.
You must be a millennial. My youngest brother is one as well. 40 years of age and he thinks his generation is the smartest ever to walk the earth. I've given up telling him otherwise.
 
1 members found this post helpful.
Old 06-22-2018, 09:00 PM   #7
laxware
Member
 
Registered: Jun 2018
Posts: 45

Original Poster
Rep: Reputation: Disabled
Quote:
Originally Posted by volkerdi View Post
Such as... ?
There are a few modifications that have to be made, a simple one is under "Encrypted root filesystem" where it says to make mkinitrd with the -smp kernel without accounting for whether or not the system is 32/64 bit (64bit systems dont require the -smp).

Another is also under "Encrypted root filesystem" where in the same mkinitrd it fails to mention the fact that you may have to add extra kernel modules in order the keyboard to work upon boot, that information (since I first used/tried Slack I found it on the docs) is found in beginner's guide on the docs where it says to run "/usr/share/mkinitrd/mkinitrd_command_generator.sh" to get the output of a mkinitrd comamnd with modules.

Another, in the same mkinitrd command, the -L argument has to be added or else you get a boot error about not being able to find "cryptroot" and the system hangs.

Another issue i also under "Encrypted root filesystem" where it says to set a root= entry in LILO, I believe doing that leads to either a dm_crypt error on boot or a "Can not mount /dev/mapper/cryptroot" type of error on boot, I can't remember which, but the solution I found from searching/reading other threads on here is to leave 'root=' empty.

Another is where it says to rename boot=/dev/mapper/cryptroot in LILO to the partition corressponding to /boot but I believe (I actually can't remember as I did not leave notes on paper or on LQ) that I just set boot=/dev/sda and that got it to work. I believe those are the only little issues.

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.

Last edited by laxware; 06-22-2018 at 09:12 PM.
 
2 members found this post helpful.
Old 06-22-2018, 09:07 PM   #8
laxware
Member
 
Registered: Jun 2018
Posts: 45

Original Poster
Rep: Reputation: Disabled
Quote:
Originally Posted by Gerard Lally View Post
You must be a millennial. My youngest brother is one as well. 40 years of age and he thinks his generation is the smartest ever to walk the earth. I've given up telling him otherwise.
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.
 
2 members found this post helpful.
Old 06-22-2018, 09:15 PM   #9
laxware
Member
 
Registered: Jun 2018
Posts: 45

Original Poster
Rep: Reputation: Disabled
Okay so the account I made on the docs.slackware.com wiki got deleted, have a good day.
 
Old 06-22-2018, 09:42 PM   #10
onebuck
Moderator
 
Registered: Jan 2005
Location: Summer Midwest USA, Central Illinois, Winter Central Florida
Distribution: Slackware«
Posts: 13,449
Blog Entries: 32

Rep: Reputation: 2632Reputation: 2632Reputation: 2632Reputation: 2632Reputation: 2632Reputation: 2632Reputation: 2632Reputation: 2632Reputation: 2632Reputation: 2632Reputation: 2632
Member response

Hi,

Quote:
Originally Posted by laxware View Post
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.
In my first post to your thread I pointed to the necessary things. And you should read through the initial Start page.
Try not to be too defensive.
We are trying to help you.

Quote:
Originally Posted by laxware View Post
You have to understand not everyone has your level of expertise, I understand Slackware is a bit of a niche distro but I don't see how you can expect someone to devote every minute of their free time looking extensively at everything.
By making statements of this sort you will not make many friends here on the forum. I for one am proud to be a Gnu/Slackware user and I do not like to hold a new users hand. The information is out there and you need to jump in and exhaustive research when doing anything right.

Quote:
Originally Posted by laxware View Post
Getting to understand and "play around" with Slackware already takes out hours of someone's time, then speculating every single aspect of the docs wiki is another. I don't know anyone personally who would be anywhere near close to what I am doing, the people who use Linux are already a small bunch, the people who use Slackware are even smaller, cut me some slack.
You have supporting data to show us? Open your eyes, we have literally a world community using Slackware. So your broad statement is just that you are painting with a broad brush and not really seeing the big picture therefore not providing any real information other than your opinion.

Quote:
Originally Posted by laxware View Post
I like the distro and want to contribute in some way, I may just post a guide here on LQ but I wanted to put it on the docs to ensure it maintains longevity and it makes the OS feel a bit more polished
The place to post such is;
Quote:
LinuxQuestions.org Member Success Stories
Just spent four hours configuring your favorite program? Just figured out a Linux problem that has been stumping you for months?
Post your Linux Success Stories here.
Still the information should be through and valid. Again you must do your research because any information to be posted within that forum will be check thoroughly.

Quote:
Originally Posted by laxware View Post
The guide that I want to make is basically a snippet/adaptation of the README_Crypt that points out some of its outdatedness (some of the stuff the README says no longer works anymore). I have figured out what you have to do and it works well enough to be replicated and I think is useful to other people. I know if someone else already made a guide like that I would have had LUKS encryption set up very quickly.
As PV posted in #5 give us some examples. I'm sure PV would accept any useful information.
Quote:
Originally Posted by laxware View Post
Again...you can't expect me to learn the 100% inner workings of the system just to post a guide on doing a particular part. Linux is really useful and to get people to use it requires to make some tutorials/howtos.
Then how do you expect to contribute to the Slackware documentation project? Your interpretation of a document/README transferred to a presentable doc?
Quote:
Originally Posted by laxware View Post
I set up my own VPN on linux because of a tutorial that was available, I understand the basics and as time goes I understand a bit more, if it were not for that tutorial I would have settled for some crappy proprietary VPN software server/client combo with GUIs on Windows and would understand even less about what I was doing.
You had to do some reading to understand that tutorial. So why not spend some time reading the initial Slackware Documentation page? If you do a scan through most doc sites you will find side bars to aid you with getting information. Our doc site is simple and easy to read and walk through. Yes, your submissions will be vetted before posting. So I would be certain to thoroughly research data available to you so the doc to be submitted is valid.
Boasting here on the forum about your achievement will get you nothing and proves that you have the sense to at least research some but not thoroughly.

Please be aware that you have already made statements to two of the most important Slackware contributors, PV (volkerdi) Slackware maintainer and Eric (Alien Bob) a major Slackware contributor.

Gnu/Slackware is the best UNIX like OS available to us lowly proud users.

Stepping on toes will get you nothing!
Hope this helps.
Have fun & enjoy!
 
1 members found this post helpful.
Old 06-22-2018, 10:42 PM   #11
laxware
Member
 
Registered: Jun 2018
Posts: 45

Original Poster
Rep: Reputation: Disabled
Quote:
Originally Posted by onebuck View Post
Hi,

In my first post to your thread I pointed to the necessary things. And you should read through the initial Start page.
Try not to be too defensive.
We are trying to help you.


By making statements of this sort you will not make many friends here on the forum. I for one am proud to be a Gnu/Slackware user and I do not like to hold a new users hand. The information is out there and you need to jump in and exhaustive research when doing anything right.

You have supporting data to show us? Open your eyes, we have literally a world community using Slackware. So your broad statement is just that you are painting with a broad brush and not really seeing the big picture therefore not providing any real information other than your opinion.

The place to post such is; Still the information should be through and valid. Again you must do your research because any information to be posted within that forum will be check thoroughly.

As PV posted in #5 give us some examples. I'm sure PV would accept any useful information.
Then how do you expect to contribute to the Slackware documentation project? Your interpretation of a document/README transferred to a presentable doc?
You had to do some reading to understand that tutorial. So why not spend some time reading the initial Slackware Documentation page? If you do a scan through most doc sites you will find side bars to aid you with getting information. Our doc site is simple and easy to read and walk through. Yes, your submissions will be vetted before posting. So I would be certain to thoroughly research data available to you so the doc to be submitted is valid.
Boasting here on the forum about your achievement will get you nothing and proves that you have the sense to at least research some but not thoroughly.

Please be aware that you have already made statements to two of the most important Slackware contributors, PV (volkerdi) Slackware maintainer and Eric (Alien Bob) a major Slackware contributor.

Gnu/Slackware is the best UNIX like OS available to us lowly proud users.

Stepping on toes will get you nothing!
Hope this helps.
Have fun & enjoy!
I am not being defensive, I thought of what to write to you to explain what I am trying to mean, the best way I can put it is the computer culture from the 90s is long gone. I am 23 years old and even in a technical college/uni there are far and few that I have met who are willing to dedicate their time tinkering with systems, even more so Linux. Outside of the techies the other people I meet don't know anything about computers and don't want to know. The ideology doesn't exist anymore and really there are going to be fewer and fewer, it is important to adapt and that you can not have the barrier of hours upon hours of time being spent as people (at least my age and younger) are not willing to do that anymore. Its a big shift and a good way to help adapt to the change is to make howtos, get people to use Slackware instead of ubuntu/debian and then as they eventually start to tinker with it they will see the benefits.
All is already known here it seems anyway, no resolution.

Last edited by laxware; 06-22-2018 at 11:07 PM.
 
Old 06-22-2018, 10:49 PM   #12
Richard Cranium
Senior Member
 
Registered: Apr 2009
Location: Carrollton, Texas
Distribution: Slackware64 14.2
Posts: 3,504

Rep: Reputation: 1833Reputation: 1833Reputation: 1833Reputation: 1833Reputation: 1833Reputation: 1833Reputation: 1833Reputation: 1833Reputation: 1833Reputation: 1833Reputation: 1833
Quote:
Originally Posted by laxware View Post
I am not being defensive, I thought of what to write to you to explain what I am trying to mean, the best way I can put it is the computer culture from the 90s is long gone. I am 23 years old and even in a technical college/uni there are far and few that I have met who are willing to dedicate their time tinkering with systems, even more so Linux. Outside of the techies the other people I meet don't know anything about computers and don't want to know.
*giggles*

Man, it has always been like that.
 
1 members found this post helpful.
Old 06-23-2018, 12:17 AM   #13
mralk3
Senior Member
 
Registered: May 2015
Location: Utah, USA
Distribution: Slackware 14.2 || Slackware-current && CentOS
Posts: 1,378

Rep: Reputation: 746Reputation: 746Reputation: 746Reputation: 746Reputation: 746Reputation: 746Reputation: 746
How can one contribute to docs.slackware.com ?

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.
 
2 members found this post helpful.
Old 06-23-2018, 12:34 AM   #14
Richard Cranium
Senior Member
 
Registered: Apr 2009
Location: Carrollton, Texas
Distribution: Slackware64 14.2
Posts: 3,504

Rep: Reputation: 1833Reputation: 1833Reputation: 1833Reputation: 1833Reputation: 1833Reputation: 1833Reputation: 1833Reputation: 1833Reputation: 1833Reputation: 1833Reputation: 1833
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.
 
1 members found this post helpful.
Old 06-23-2018, 12:40 AM   #15
mralk3
Senior Member
 
Registered: May 2015
Location: Utah, USA
Distribution: Slackware 14.2 || Slackware-current && CentOS
Posts: 1,378

Rep: Reputation: 746Reputation: 746Reputation: 746Reputation: 746Reputation: 746Reputation: 746Reputation: 746
Quote:
Originally Posted by Richard Cranium View Post
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.
I agree, but in order to write you must first learn to read.
 
  


Reply


Thread Tools Search this Thread
Search this Thread:

Advanced Search

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is Off
HTML code is Off



Similar Threads
Thread Thread Starter Forum Replies Last Post
Contributing to docs.slackware.com navigium Slackware 4 06-19-2016 08:54 AM
docs.slackware.com is down :( Nh3xus Slackware 15 07-14-2015 11:45 AM
LXer: How to contribute to the MySQL Docs LXer Syndicated Linux News 0 07-20-2006 07:21 PM
Need slackware configuration docs Kocil Slackware 10 06-18-2003 12:47 PM
Slackware Docs/help pages mythology Slackware 2 12-13-2002 08:50 PM

LinuxQuestions.org > Forums > Linux Forums > Linux - Distributions > Slackware

All times are GMT -5. The time now is 09:41 AM.

Main Menu
Advertisement
My LQ
Write for LQ
LinuxQuestions.org is looking for people interested in writing Editorials, Articles, Reviews, and more. If you'd like to contribute content, let us know.
Main Menu
Syndicate
RSS1  Latest Threads
RSS1  LQ News
Twitter: @linuxquestions
Facebook: linuxquestions Google+: linuxquestions
Open Source Consulting | Domain Registration