/|\

Welcome to the Slackware Documentation Project

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
slackdocs:news [2012/08/22 22:06 (UTC)]
alienbob Long overdue but created at last. WIP!
slackdocs:news [2015/04/03 21:46 (UTC)] (current)
alienbob Fix a section header.
Line 1: Line 1:
 ====== News from the site admins ====== ====== News from the site admins ======
  
-<note>This page will be expanded soon, hopefully during the weekend.</note> 
  
-======= The choice of software =======+====== Project Charter ======
  
 +Knowledge is power. Scattered and unfocused power is useless. To state it plainly, the vision and the ultimate goal of the //Slackware Linux Documentation Project// is to become the primary worldwide resource for all Slackware related information. This is a lofty goal, indeed. However, there is confidence that venerable [[http://slackware.com/|Slackware Linux]], the oldest actively maintained distribution of [[https://www.gnu.org/|GNU/Linux]], has the user base to accomplish this goal. You are invited to [[http://docs.slackware.com/start?do=register|join]] and be a partner in this endeavor. 
  
-This Wiki runs the [[http://dokuwiki.org/ DokuWiki]] softwareBasically when setting up a serious wiki there are two choices: [[http://mediawiki.org| MediaWiki]] and DokuWiki. [[wiki:user:alienbob|I]] have extensive experience with both - running DokuWiki for my own [[http://alien.slackbook.org/ | Slackware knowledgebase]], and running a MediaWiki based knowledgebase for the customer Helpdesk I am the teamleader of.+Who can help? Anyone can, from your uncle Ed who tinkers with Slackware on his old laptop to Linux gurus with development level skill sets. All are welcome. All can [[slackdocs:contributing|contribute]] something of value to this projectwiki type resource such as this thrives on communityYou've seen for yourselves what the GNU/Linux and [[http://www.thefreedictionary.com/open-source|Open Source]] communities have done in the past and are still doing today. Working togetherthe potential for success is greatly increased.
  
-The choice for DokuWiki was made for several reasons: its syntax makes it more suitable for writing documentation as opposed to MediaWiki which is more general-purposeAlsoDokuWiki is self-contained in a single directory and does not require a SQL databasewhich makes it highly portable (I intend to make a "daily snapshot" tarball available for download once the Wiki fundament is complete)The DokuWiki also allows the use of Access Control Lists which we are going to implement after we have formed a team of editors (those who are going to be responsible for having high-quality texts while you, the authors, are responsible for the technical content).+This project will need article submissions that run the entire gamut of Slackware knowledgeThere will be a need for serious technical articles on hardware controlsoftware applications, Slackware Linux implementations in business and personal computingsystem administration, etcArticles will also be needed from the every day [[https://www.linuxquestions.org/questions/slackware-14/so-you-want-to-be-a-slacker-what-do-i-do-next-644746/|Slacker]] on topics ranging from simple howtos to complicated resolutions and workarounds
  
-The Wiki's functionality has been extended with several syntax pluginswhich you will find listed at the bottom of the [[wiki:syntax|Wiki syntax]] pageYou can follow the links for those plugins if you want to learn what they allow you to do when writing an article.+Submitted articles, as with most wiki type resources, will be peer reviewedCorrections may be needed, amendments added, and so forth. No article should be deemed unimportant. If it has relevance to Slackware Linux and will assist someone somewhere to better utilize this operating system, then it is a worthwhile article. What is being done here is being done for others. This is an archive of knowledge being built for the future. Your participation will be the mortar that holds the bricks in place.
  
-====== Artwork ======+In order to fulfill the goals of this project, a reliance on civil discourse and the presence of a strong spirit of cooperation will be necessary. The rules here are simple. Be kind and considerate in your dealings with others. This project is not about individuals. It's about a community sharing and working together toward a goal. Your ego will not be a part of the //Slackware Linux Documentation Project//. Please leave it in the coat closet by the front door before you login.
  
-The artwork used at the moment was created by [[wiki:user:asteroid|asteroid]] who has some more examples of nice graphics on his own user page. \\ I asked (and received permission) from Patrick Volkerding to use these modifications of original Slackware artwork here on the Wiki.+That is the our contract with one another and with the future
  
-====== Sidebar ====== 
  
-To the left of the page you will find a sidebar with several boxes which can be edited (by the admins). Only the "toolbox" box is part of the monobook template we are using for the site, and can not be modified (or rather, I do not want to modify it because that makes future upgrades a pain). \\ If you have suggestions about entries which should absolutely be in one of thoose boxes, let us know (use the [[talk:slackdocs:news|discussion page]]).+====== The choice of software ======
  
  
-====== Project Charter ======+This Wiki runs the [[http://dokuwiki.org/ | DokuWiki]] software. This choice was made by the initiator of the project, [[wiki:user:alienbob|Alien BOB]]. Basically when setting up a serious wiki there are two choices: [[http://mediawiki.org/ | MediaWiki]] and DokuWiki. [[wiki:user:alienbob|Alien BOB]] has extensive experience with both - running DokuWiki for his own [[http://alien.slackbook.org/ | Slackware knowledgebase]], and running a MediaWiki based knowledgebase for the customer Helpdesk of which he is the teamleader.
  
-FIXME+The choice for DokuWiki was made for several reasons; its syntax makes it more suitable for writing documentation as opposed to MediaWiki, which is more general-purpose. Also, DokuWiki is self-contained in a single directory and does not require an SQL database, which makes it highly portable (the intention is to make a "daily snapshot" tarball available for download once the Wiki foundation is complete). The DokuWiki also allows the use of Access Control Lists - a quality control measure which will be implemented after the formation of a proper team of editors (those who are going to be responsible for having high-quality texts while you, the authors, are responsible for the technical content). 
 + 
 +The Wiki's functionality has been extended with several syntax plugins, which you will find listed at the bottom of the [[wiki:syntax|Wiki syntax]] page. You can follow the links for those plugins if you want to learn what they allow you to do when writing an article. 
 + 
 +====== Artwork ====== 
 + 
 +The artwork used at the moment was created by [[wiki:user:asteroid|asteroid]] who has some more examples of nice graphics on his own user page. \\ The admins asked (and received permission) from Patrick Volkerding to use these modifications of original Slackware artwork here on the Wiki. 
 + 
 +====== Sidebar ====== 
 + 
 +To the left of the page you will find a sidebar with several boxes which can be edited (by the admins). Only the "toolbox" box is part of the wiki's //[[https://www.dokuwiki.org/template:monobook | monobook]]// template, and can not be modified. More specifically,modifying the content of that toolbox would make future upgrades a pain. \\ If you have suggestions about entries which should absolutely be in one of those boxes, let us know (use the [[talk:slackdocs:news|discussion page]]).
  
-This is going to be the paragraph where we will explain the goals of and vision behind this documentation project, and the "rules" we want to define for its content. Call it a "social contract" if you decide you want to contribute to the project. 
  
 ====== Community driven ====== ====== Community driven ======
  
 Even though this documentation site has a hostname in the [[http://slackware.com/ | slackware.com]] domain, that does not mean it is a Slackware-controlled or sponsored project. The use of the domain name is a token of approval, rather. Also, the project was bootstrapped by [[wiki:user:alienbob|Alien BOB]], a Slackware coreteam member.\\ The content of the Wiki will not be controlled by "//higher powers//". The content on any page in this wiki is determined by its author(s) and contributor(s). Even though this documentation site has a hostname in the [[http://slackware.com/ | slackware.com]] domain, that does not mean it is a Slackware-controlled or sponsored project. The use of the domain name is a token of approval, rather. Also, the project was bootstrapped by [[wiki:user:alienbob|Alien BOB]], a Slackware coreteam member.\\ The content of the Wiki will not be controlled by "//higher powers//". The content on any page in this wiki is determined by its author(s) and contributor(s).
 +
  
 ====== Wiki structure ====== ====== Wiki structure ======
  
-The core structure of the Wiki will be maintained by the site admins. That means: [[https://www.dokuwiki.org/namespaces | namespaces]], visual identity, access controls and the like. Ideas for changing the core structure of the Wiki can be submitted through our mailing list ([[http://lists.alienbase.nl/mailman/listinfo/slackdocs | http://lists.alienbase.nl/mailman/listinfo/slackdocs]]) or by editing the [[talk:slackdocs:news|discussion page]]. //__The actual content is all up to you!__// We will not refuse any article.+The core structure of the Wiki will be maintained by the site admins. That means: [[https://www.dokuwiki.org/namespaces | namespaces]], visual identity, access controls and the like. It also means that the namespaces "[[slackware:|slackware:]]", "[[slackdocs:|slackdocs:]]" and "[[slackbook:|slackbook:]]" are read-only for everyone except the editor/admin team. 
 + 
 +Ideas for changing the core structure of the Wiki can be submitted through our mailing list ([[http://lists.alienbase.nl/mailman/listinfo/slackdocs | http://lists.alienbase.nl/mailman/listinfo/slackdocs]]) or by editing the [[talk:slackdocs:news|discussion page]]. //__The actual content is all up to you!__// We are open to good ideas for enhancement of the existing structure and content, and will not refuse any article in the "[[howtos:|howtos:]]" section. 
  
 ====== Assuring quality ====== ====== Assuring quality ======
  
 [//Not implemented yet//] [//Not implemented yet//]
-Our goal is to give you total creative freedom when writing content for the Wiki. But for the sake of quality assurance, we ask you to co-operate with one of our editors. \\ He or she may be able to offer suggestions about tags to use in your article so that it gets properly listed in the TOC. We also have tag categories that allow you to indicate your article applies to certain versions of Slackware only. You get the idea? You can also discuss an appropriate namespace to put your article in (consider a namespace as a wiki equivalent of a subdirectory - actually that is how it is implemented in the server's filesystem). The editor's primary role is to advise you on the structure of your article, ensure that it looks good, uses well-formed sentences - essentially that what any book editor would also do for you. You (the author of the article) will remain in control over the technical content! The editor will not enter into discussions about the (technical) content of yur article, unless he spotted blatant errors of course. We assume that since you wrote it, you know better what you are talking about than do we...+Our goal is to give you total creative freedom when writing content for the Wiki. But for the sake of quality assurance, we ask you to co-operate with one of our editors. \\ He or she may be able to offer suggestions about tags to use in your article so that it gets properly listed in the TOC. We also have tag categories that allow you to indicate your article applies to certain versions of Slackware only. You get the idea? You can also discuss an appropriate namespace to put your article in (consider a namespace as a wiki equivalent of a subdirectory - actually that is how it is implemented in the server's filesystem). The editor's primary role is to advise you on the structure of your article, ensure that it looks good, uses well-formed sentences - essentially that what any book editor would also do for you. You (the author of the article) will remain in control over the technical content! The editor will not enter into discussions about the (technical) content of your article, unless he spotted blatant errors of course. We assume that since you wrote it, you know better what you are talking about than do we..
 + 
 +In order to assist the editor with his work, the Wiki implements a mechanism of "publishing a page". This means that the creation of a new page, or editing an existing page, will automatically put that page in "Draft" mode. The "Draft" message will be prominently visible on the page. If you are editing an existing page, then the original (approved) page will remain be visible to visitors of our Wiki. Only the registered users of the wiki (i.e. your fellow authors) will be able to see the draft instead of the approved version. \\ You have to consult one of our editors to get your page revision approved. That action will make it visible to the world.
  
-In order to assist the editor with his work, the Wiki implements a mechanism of "publishing a page". This means that the creation of a new page, or editing an existing page, will automatically put that page in "Draft" mode. The "Draft" message will be prominemtly visible on the page. If you are editing an existing page, then the original (approved) page will remain be visible to visitors of our Wiki. Only the registered users of the wiki (i.e. your fellow authors) will be able to see the draft instead of the approved version. \\ You have to consult one of our editors to get your page revision approved. That action will make it visible to the world. 
  
 ====== Respect other people's work ====== ====== Respect other people's work ======
Line 47: Line 60:
  
 The content of this wiki is published under a liberal "Creative Commons" license: [[http://creativecommons.org/licenses/by-sa/3.0/ | CC Attribution-Share Alike 3.0 Unported]] . Take this into consideration if you intended to publish copyrighted information here. The content of this wiki is published under a liberal "Creative Commons" license: [[http://creativecommons.org/licenses/by-sa/3.0/ | CC Attribution-Share Alike 3.0 Unported]] . Take this into consideration if you intended to publish copyrighted information here.
 +
 +====== Sources ======
 +  * Original author: [[wiki:user:alienbob|Eric Hameleers]]
 +  * Contributors: [[wiki:user:nocturnal.slacker|V. T. Eric Layton]]
  
 <!-- Please do not add anything below, except additional tags.--> <!-- Please do not add anything below, except additional tags.-->

In Other Languages
QR Code
QR Code slackdocs:news (generated for current page)