The Big Manual

Here wizards, magicians, sorcerers and everybody can rest a bit and talk about anything they like.

Just remember to respect the rules.

The Big Manual

Postby tuxpenguin8 » May 24th, '14, 18:31

Hi,

I had an idea that there would be a big manual about everything about mageia and computer. I know not much about both. The documentation team apparently have a hard time making documentation. So to make a big manual possible, lots of people have to contribute, so new people can learn about computers and mageia. So this is to sys admins, developers and advanced users. I would like your help so we can help the documentation team do their job. It would be great if you shared your knowledge to help a documentation of it. So, I would like to know where you got your knowledge from to help this manua possible. So if you know anything about being an advanced user, being a sys admin, being a developer, and about hardware and how computers work, please share all your info and help the documentation team, so other people can learn about it in a massive manual. And if you know of any generic linux documentation or stuff about how computers work and about hardware please share them and contribute to the documentation team so everything is in a centreal place.

This is about the big guide: viewtopic.php?f=11&t=7658

Thanks,
tuxpenguin8
 
Posts: 40
Joined: Apr 18th, '14, 22:00
Location: Norfolk, UK

Re: The Big Manual

Postby Ken-Bergen » May 25th, '14, 01:13

You're putting the cart before the horse. :shock:

How would one gather this huge team to make this definitive guide to Mageia/Linux and computer hardware which you say would attract more developers and document writers when we're struggling not only to write/develop but to get up to date?
Ken
Ken-Bergen
 
Posts: 1018
Joined: Mar 30th, '11, 02:45
Location: Chilliwack, BC, Canada

Re: The Big Manual

Postby jkerr82508 » May 25th, '14, 02:52

It is certain that any documentation will have to be extensively edited and updated for each new Mageia release. Since Mageia is an international distribution it should also be translated. This would require a continuing commitment by a very large group of people.

IMHO, anyone who is able and willing to contribute documentation to Mageia should join the doc team and help to maintain and expand the official documentation and the wiki:

https://wiki.mageia.org/en/Documentation_team

or write and edit wiki pages as a "free agent". The wiki is, in fact, the Mageia part of the "massive manual" that you want to create. It is where Mageia people share their knowledge.

There already exist numerous books and other information sources about computers and generic linux systems.

Jim
jkerr82508
 
Posts: 943
Joined: Mar 26th, '11, 01:34
Location: Fife, Scotland

Re: The Big Manual

Postby tuxpenguin8 » May 25th, '14, 14:07

Hi,

I don't know how to get all the sys admins, advanced users and developers. But If they all work together to make an ultimate guide on a release, mageia will gain more developers and users because all the info they need will be in one place, so it would be easier to learn about mageia, computers and development. And one of the main goals of the mageia project is to have a smart community, if every bit bit of info was organised into a manual, so if you learn one thing it will lead you onto another, it would allow for you to learn quicker, and learn stuff that you should know to continue. And The wiki is the mageia part of the manual, but if it were organised into a manual it would be even easier to learn and advance to the next level.

If you know any sys admins, advanced users, developers, who you think may be able to help the documentation team, it would be great if they help, because help will make more documentation, and organised into a manual, allowing for smarter community.

Thanks,
tuxpenguin8
 
Posts: 40
Joined: Apr 18th, '14, 22:00
Location: Norfolk, UK

Re: The Big Manual

Postby doktor5000 » May 25th, '14, 15:17

tuxpenguin8 wrote:If you know any sys admins, advanced users, developers, who you think may be able to help the documentation team, it would be great if they help, because help will make more documentation, and organised into a manual, allowing for smarter community.

Then spread the word.
This is the case since the start of Mageia project, and this is probably the situation for nearly all other open source projects.
And even if there was one ultimate manual about computers, Mageia, life and everything else - doesn't mean people will read it.

You know, we already have quite some good documentation on Mageia in the wiki and on http://www.mageia.org/en/doc/
But most people simply don't want to read for themselves, even when you point them to the documentation they will ask how to
do abc or how to fix the issue with xyz.
Cauldron is not for the faint of heart!
Caution: Hot, bubbling magic inside. May explode or cook your kittens!
----
Disclaimer: Beware of allergic reactions in answer to unconstructive complaint-type posts
User avatar
doktor5000
 
Posts: 15029
Joined: Jun 4th, '11, 10:10
Location: Leipzig, Germany

Re: The Big Manual

Postby tuxpenguin8 » May 25th, '14, 18:14

Hi,

The wiki is great for info on stuff but it can be a little hard if your trying to learn loads of different stuff about mageia. I fore one, are using the wiki to learn bash.

If you need some quick info, the wiki is the place. If you need to learn all the stuff about mageia, this guide needs to be there so anyone can learn everything about mageia and computers.

Thanks,
tuxpenguin8
 
Posts: 40
Joined: Apr 18th, '14, 22:00
Location: Norfolk, UK

Re: The Big Manual

Postby doktor5000 » May 25th, '14, 18:23

So if the guide should not be in the wiki, then where should it be then?
Cauldron is not for the faint of heart!
Caution: Hot, bubbling magic inside. May explode or cook your kittens!
----
Disclaimer: Beware of allergic reactions in answer to unconstructive complaint-type posts
User avatar
doktor5000
 
Posts: 15029
Joined: Jun 4th, '11, 10:10
Location: Leipzig, Germany

Re: The Big Manual

Postby tuxpenguin8 » May 26th, '14, 11:12

Hi,

It would be on the wiki, since the wiki already has tonnes of info, it would just be organised into a book. And it would come with mageia as a printable PDF image. If it is printable, distribution of the manual will be much easier, and there for Linux User Groups can use the, schools can print the off and distrubute them, making it printable and redistrubuting them for free, will allow anyone to learn, even if they don't have a PC.

There will be terms and conditions on prining the manual and redistrubting them.

Thanks,
tuxpenguin8
 
Posts: 40
Joined: Apr 18th, '14, 22:00
Location: Norfolk, UK

Re: The Big Manual

Postby tuxpenguin8 » May 26th, '14, 11:19

If you know of any generic resoures of how computers work, abou hardware, generic sources about linux ,coding,managing a system, please contribute, and put them below, and put comments, queries and suggestions below.

Thanks,-
tuxpenguin8
 
Posts: 40
Joined: Apr 18th, '14, 22:00
Location: Norfolk, UK

Re: The Big Manual

Postby doktor5000 » May 26th, '14, 21:16

Some free online ressources:
http://rute.2038bug.com/index.html.gz
http://web.archive.org/web/201306171645 ... ixsrv.com/ -> especially the interactive version http://web.archive.org/web/201306290506 ... .com/llthw
http://oreilly.com/openbook/
http://www.tldp.org/
http://www.linuxfromscratch.org/index.html
http://en.wikibooks.org/wiki/Subject:Computing
https://www.galileo-press.de/openbook/ (sadly only in german)
http://docstore.mik.ua/ (includes has some books which are out of print)
http://www.makelinux.net/kernel_map/
http://cli.learncodethehardway.org/book/
http://steve-parker.org/sh/sh.shtml
http://www.linuxrsp.ru/win-lin-soft/table-eng.html

Some real books I can recommend:
UNIX and Linux System Administration Handbook - 4th Edition (Prentice Hall)
Unix in a Nutshell, Fourth Edition (Oreilly) - basically everything else from Oreilly too
The Design and Implementation of the 4.4BSD Operating System (Addison-Wesle​y Unix and Open Systems)
The Unix Programming Environment (Prentice-Hall Software Series)
The Practice of System and Network Administration (Addison-Wesle​y Professional Computing)
TCP/IP Illustrated Volumes 1-3 Boxed Set [With Poster] (Addison-Wesle​y Professional Computing)
Cauldron is not for the faint of heart!
Caution: Hot, bubbling magic inside. May explode or cook your kittens!
----
Disclaimer: Beware of allergic reactions in answer to unconstructive complaint-type posts
User avatar
doktor5000
 
Posts: 15029
Joined: Jun 4th, '11, 10:10
Location: Leipzig, Germany

Re: The Big Manual

Postby tuxpenguin8 » May 27th, '14, 09:38

Hi,

Thanks for the sources you have contributed. They will help me learn about linux and computers. They will help anyone who reads this forum post. And they will help to educated more people, so the big manual is more likely to happen.

Thanks,
tuxpenguin8
 
Posts: 40
Joined: Apr 18th, '14, 22:00
Location: Norfolk, UK

Re: The Big Manual

Postby tuxpenguin8 » May 28th, '14, 11:34

Hi,

I've found a website that may be of help about the kernel: http://kernelnewbies.org/ I hope this helps

Thanks,
tuxpenguin8
 
Posts: 40
Joined: Apr 18th, '14, 22:00
Location: Norfolk, UK

Re: The Big Manual

Postby doktor5000 » Jun 5th, '14, 01:06

This one also seems to have received good critics, and even mentions Mageia on the cover as a popular distro :)
http://distrowatch.com/weekly.php?issue=20130506#qa
Cauldron is not for the faint of heart!
Caution: Hot, bubbling magic inside. May explode or cook your kittens!
----
Disclaimer: Beware of allergic reactions in answer to unconstructive complaint-type posts
User avatar
doktor5000
 
Posts: 15029
Joined: Jun 4th, '11, 10:10
Location: Leipzig, Germany


Return to The Wizards Lair

Who is online

Users browsing this forum: No registered users and 1 guest