[2024-feb-29] Sad news: Eric Layton aka Nocturnal Slacker aka vtel57 passed away on Feb 26th, shortly after hospitalization. He was one of our Wiki's most prominent admins. He will be missed.

Welcome to the Slackware Documentation Project

Ceci est une ancienne révision du document !


En cours de traduction
Préférez éditer les sections (en cliquant sur le bouton [éditer] à côté des titres de section plutôt qu'éditer la page entière, afin que d'autres puissent éditer en même temps.

Idées pour contribuer au wiki de docs.slackware.com

Contribuer à la documentation d'un projet peut être une tâche vraiment enrichissante et satisfaisante, mais beaucoup de contributeurs potentiels sont intimidés par la perspective d'écrire une documentation. L'idée derrière un wiki n'est pas de créer une documentation parfaite directement, mais d'encourager la communauté à faire des améliorations progressives pour finaliser le document. Inutile donc d'être déconcerté par cette idée.

Chacun peut choisir le ou les sujets auxquels contribuer, en se sentant à l'aise de rajouter des connaissances. Chaque contributeur potentiel trouvera un sujet qui lui convienne.

Éditer, développer, améliorer

Éditer, développer et améliorer les articles existants est un bon exercice pour s'impliquer et contribuer à une documentation sous wiki. En tant que projet collaboratif toutes les corrections et améliorations sont bienvenues.

Il ne faut pas croire qu'éditer ou corriger est moins important qu'écrire un nouvel article ! Éditer, corriger et améliorer fait partie intégrante d'un wiki, et il est important de maintenir le contenu à jour.

Rédaction d'article

Quand vous serez suffisamment à l'aise avec l'édition et l'amélioration d'articles existants, voilà quelques idées pour participer à l'élaboration de la documentation, sans ordre particulier.

HOWTOs/Tutoriels

Les HowTos, documents pour effectuer certaines tâches spécifiques ou parvenir à un certain résultat, sont très apprécié par la communauté du logiciel libre. Ces HowTos mettent l'accent sur une tâche spécifique et comment l'effectuer, pas à pas, avec des explications et des illustrations. Les notes et les avertissements jouent un rôle important dans ce type d'articles et aident le lecteur à éviter certains pièges.

Quelques exemples de potentiels HowTos :

  • Comment configurer une connexion wifi
  • Comment configurer un serveur web/FTP/mail.
  • Comment configurer un firewall sur un ordinateur de bureau.

et tout ce qui peut vous passez par la tête.

Programmes ou applications spécifiques

Cette catégorie recense des articles courts et informatifs relatifs à des programmes ou des applications spécifiques. Ces articles ne sont pas destinés à être des substituts pour les pages d'aide générées par man. Toutefois, ils peuvent fournir l'information nécessaire pour commencer par utiliser les programmes ou applications en question et aussi s'attarder sur des caractéristiques particulières qui pourraient nécessiter de plus amples détails.

A titre d’exemple, les applications bureautiques ou les outils de gestion de paquets constituent des sujets potentiels.

Articles généraux

Il s'agit ici d'articles ne ciblant pas un problème technique en particulier mais plutôt se concentrant sur des sujets de plus large portée. L'inclusion de détails techniques dans un article général est facultatif. L'article peut toutefois être étendu plus tard afin de fournir des liens ou des pointeurs vers des sources d'information plus détaillées et techniques portant sur des sujets identiques ou similaires.

L'article Slackware philosophy est un exemple d'article général.

Subjects to cover

The following list is based on Woodsman's suggestion. It can serve as a good guide to add content to the wiki.

  • An introductory guide, focusing on features and highlighting the software. Somewhat a marketing tool but technical in nature.
  • A startup guide, focusing on the basics of using the software.
  • A quick reference guide, focusing on mouse and keyboard shortcuts as well as the most common tasks.
  • A fat user guide, focusing on all elements of using the software. Often includes tutorials.
  • An administrator's guide. This is the stuff that makes most people's eyes water but is the first thing a geek grabs when confronted with problems.
  • Introduction and Welcome Guide
    • What is Slackware?
    • How Does Slackware Differ From Windows and Macs?
    • What is Linux?
    • What is GNU/Linux?
    • The Idea of Free/Libre Software
  • Startup Guide — An Overview
    • The KDE Desktop
    • The Xfce Desktop
    • The Fluxbox Desktop
    • Basic Mouse and Keyboard Techniques
    • Basic Keyboard Shortcuts
    • Using Menus
    • Using Dialog Boxes
    • Finding Help
  • Reference Guide — Some Computer Fundamentals
    • A Multitasking and Multiuser Computer System
    • Security and User Permissions
    • Logging In
    • Logging Out
    • Creating User and Group Accounts
    • Shutting Down Properly
    • Customizing the Desktop
    • Customizing the Desktop for People with Special Needs
    • Customizing for Multiple Languages
    • Adding “Quick Launch” Icons to the Task Bar
    • Adding Items to the System Menu
    • Understanding Folders and Files
    • System Files and User Files
    • Using a File Manager
    • Finding Files
    • Using a Printer
    • Setting the System Clock
    • Terminating Programs That Crash or Freeze
    • Connecting to the Internet
    • Finding New Programs
    • Automatically Updating Programs
    • Viruses and Malware
  • User Guide — How Do I . . .
    • Play Solitaire?
    • Quickly calculate some numbers?
    • Surf the web?
    • View a PDF file?
    • Send and receive email?
    • Organize my schedule?
    • Write a formal letter?
    • Edit basic text files?
    • Jot notes to myself?
    • Use special keyboard characters?
    • Schedule reminders and alarms for myself?
    • Let the children “paint”?
    • Do some serious drawing?
    • Grab a screenshot?
    • Touch up and edit images?
    • Draw a flowchart?
    • Create some charts?
    • Learn to type?
    • Listen to music files?
    • Listen to an audio CD?
    • Adjust my audio volume?
    • Watch DVD movies?
    • Make backups of my CDs and DVDs?
    • Rip an audio CD?
    • Use my USB flash drive?
    • How do I save camera photographs?
    • Browse and manage my digital photograph collection?
    • Download and read RSS feeds?
    • Chat with my daughter with instant messaging?
    • Edit my web site pages?
    • Manage finances?
    • Manage a small-scale project?
  • Advanced Topics (Appendices or Separate Documents)
    • System Requirements
    • The Command Line Interface
    • Installing Multimedia Codecs
    • Configuring Video Cards and Monitors
    • Configuring Sound Cards
    • Configuring Mice
    • Configuring Internet and Network Connections
    • Configuring Printers
    • Configuring Page Scanners
    • Configuring TV Cards
    • Installing New Software
    • Installing Fonts
    • Installing Firefox Extensions Globally for All Users
    • Creating A Common File Storage Location
    • Scheduling System Tasks and Events
    • Modifying the Bootloader Options
    • Keeping Slackware Secure
    • Updating Security Patches
    • Obtaining Additional Packages
    • Some Thoughts About Backups
  • Administrator's Guide
    • Finding Help
    • Hard Disk Partitioning
    • Installing Slackware
    • Updating Slackware
    • Building Packages
    • Some Unix Basics
    • The Filesystem Hierarchy and Structure
    • Command Line Shell Basics
    • How the Slackware System Boots
    • System Services
    • Kernel Modules and Devices
    • Slackware Package Management
    • Emergency Repair Tricks
    • System Information and Inventory Tricks
    • Solving System Problems
    • Installing Windows in a Virtual Machine
    • Configuring a Firewall
    • Configuring a Router and Family Local Network
    • CPU Frequency Scaling
    • Power Management
    • Managing a Slackware/Windows Dual Boot System
    • Migrating Web Browser Settings
    • Migrating Email Settings

Sujets inappropriés

En dépit de la liberté d'expression et de création offert par un Wiki, certains sujets sont à éviter. Il s'agit de qu'il vaut mieux éviter dans un wiki. Certains d'entre eux peuvent être:

  • Opinions subjectives ou complaintes excessives ou abusives. Ces styles d'articles relèvent de la catégorie des blogs et non des sites d'échange d'information du style Wikis.
  • Les sujets principalement philosophiques. the Slackware way présente déjà la philosophie Slackware.
  • Les sujets qui sont critiques envers les autres distributions ou l'approche adoptée par d'autres distributions ou ses mainteneurs ou sa communauté par rapport a certaines questions. Ce genre de sujets mettrait en exergue le manque de professionnalisme de la communauté Slackware. L'accent devrait plutôt être mis sur ​​les points positifs eau lieu de pratiquer le négativisme.
  • Les sujets axées plus sur le débat que sur l’échange d'information. Par exemple, KDE vs Xfce, ou DE WM vs. Discuter des préférences pour le choix d'un environnement de bureau est une appréciation subjective et non un article informatif, à moins bien sûr que l'article présente une contribution technique bien spécifique sur le sujet.

Afin d’éviter la duplication de contenu, les contributeurs potentiels devraient également vérifier l'existence d'un sujet dans le wiki avant de créer une nouvelle page avec un sujet similaire.

Sources

  • Contribution initiale par V.Harishankar pour le projet SlackDocs Wiki.
  • Contributions additonnelles par kookiemonster à partir des suggestions de Woodsman sur les forums LinuxQuestions.org.

 fr:slackdocs:contributing ()
Cette traduction est plus ancienne que la page originale et est peut-être dépassée. Voir ce qui a changé.