Differences between revisions 4 and 28 (spanning 24 versions)
Revision 4 as of 2008-11-25 22:32:39
Size: 2481
Editor: FranklinPiat
Comment: Rewrite page (almost completly).
Revision 28 as of 2022-01-06 13:35:51
Size: 7547
Editor: ThiagoPezzo
Comment: add comment to translators
Deletions are marked like this. Additions are marked like this.
Line 2: Line 2:
##For Translators - to have a constantly up to date translation header in you page, you can just add a line like the following (with the comment's character at the start of the line removed)
##<<Include(DebianDocumentation, ,from="^##TAG:TRANSLATION-HEADER-START",to="^##TAG:TRANSLATION-HEADER-END")>>
##TAG:TRANSLATION-HEADER-START
~-Translation(s): [[DebianDocumentation|English]] - [[fr/DebianDocumentation|Français]] - [[it/DebianDocumentation|Italiano]] - [[pt_BR/DebianDocumentation|Português (Brasil)]]-~
##TAG:TRANSLATION-HEADER-END
----
Line 3: Line 9:
Debian is a distribution, made of many thousands (free) software :
 1. Most softwares provided in Debian comes with their own documentation ([#progs-docs more below]).
 1. Debian has some ''own'' documentation too ([#debian-docs more below]).
Debian is a GNU/Linux distribution, made of thousands of [[FreeSoftware|free software]] packages.
 
 . <<TableOfContents(3)>>
Line 7: Line 13:
 1. At the bottom of the page, there are some pointers if you want to contribute improvement to documentation ([#contribute more below]). This page is about official Debian Documentation.
Line 9: Line 15:
[[BR]]
[[BR]]
[[BR]]
There are other [[DebianResources|Debian Resources]]
Line 13: Line 17:
[[Anchor(progs-docs)]]
== Programs documentations ==

<<Anchor(debian-documentation)>>
= Debian Documentation =

== For users ==
The most famous for Debian users are :
 * The [[http://www.debian.org/releases/stable/installmanual|Installation Guide]] (or the [[http://d-i.alioth.debian.org/manual/|development version]].)
 * The [[http://www.debian.org/releases/stable/releasenotes|Release Notes]]
 * The [[http://www.debian.org/doc/user-manuals#quick-reference|Debian reference]]

Many other Debian Documentation are available at [[http://www.debian.org/doc|www.debian.org/doc]]

At the moment, Debian doesn't have a ''System Administrator'' manual.

== For contributors ==
The most famous for Debian contributors are :
 * the [[http://www.debian.org/social_contract|social contract]]
 * the [[http://www.debian.org/social_contract#guidelines|The Debian Free Software Guidelines (DFSG)]]
 * the [[http://www.debian.org/devel/dmup|Debian Machine Usage Policies]] (dmup)
 * the [[DebianPolicy| Debian policy]]
 * the [[http://www.debian.org/doc/devel-manuals#devref|Debian Developer's Reference Manual]]
 * the [[http://www.debian.org/doc/devel-manuals#maint-guide|Debian New Maintainers Guide]]

Most documentation for Debian-developer (and package maintainer) are available from [[http://www.debian.org/devel/|www.debian.org/devel/]].

== Official Websites of the Debian Project ==
The Debian Project has a [[http://www.debian.org/devel/constitution|constitution]] and an [[http://www.debian.org/intro/organization|organizational structure]]

On [[http://www.debian.org|Debian.org]] the official Debian site, you can find a section dedicated to documentation.

## By alphabetical order
 * http://www.debian.org/doc - Debian documentation home
 * http://www.debian.org/support - support home

<<Anchor(forums)>>
=== Forum ===
## By alphabetical order
 * [[DebianMailingLists|Mailinglists]] are the main way of Debian communication
 * http://lists.debian.org/users.html - User mailing lists
 * http://forums.debian.net - Debian.net Forums
 
=== Advocacy, developers, inside information ===
## By alphabetical order
 * UnofficialRepositories - a list of non official package repositories. They can be very useful.
 * http://alioth.debian.org - Project hosting for Open Source developers
 * http://mentors.debian.net - Public package repository
 * http://bits.debian.org - Debian Blog
 * http://planet.debian.org - Planet Debian, aggregating lots of Developer blogs
 * http://planet.debian.org/es/ - Planeta Debian, a blog aggregator in spanish
 * http://release.debian.org - Debian Release Management pages
 * http://snapshot.debian.org - Debian packages archived daily since 2002/06/04
 * http://backports.debian.org - Backports for the stable distribution
 * http://www.debian.org/News - Official news
 * http://db.debian.org - Debian Developer Database
 * http://udd.debian.org/ - Ultimate Debian Database
 
<<Anchor(wikis)>>
=== Wiki ===
Debian-related wikis:
## By alphabetical order
 * http://wiki.debconf.org - The pre-2019 !DebConf (Debian Conference) Wiki. For content since 2019, see DebConf.
 * http://wiki.debian.org - The Official Debian Wiki

<<Anchor(books)>>
== Books ==
Many free and non-free books are listed on Debian website.
 * http://www.debian.org/doc/books - Debian Book Library
Extra books could be listed below.
## DO NOT DUPLICATE entries from debian.org/doc/books !

<<Anchor(irc)>>

== Instant Messaging ==
There are official Debian [[IRC]] channels.

You can also use [[Jabber]]


<<Anchor(progs-docs)>>
= Program documentation =

Each software provides has its own documentation.
 
Line 16: Line 101:
 * A [:ManPage:manpage] (type {{{man}}} followed by a command name).  * A [[ManPage|manpage]] (type {{{man}}} followed by a command name).
Line 20: Line 105:
 * Some program provide their documentation as html, or ''[wiki:WikiPedia:Info_(Unix) info]'' page.  * Some program provide their documentation as html, or ''[[WikiPedia:Info_(Unix)|info]]'' page.
Line 22: Line 107:
[[Anchor(debian-docs)]]
== Debian Documentation ==
== Package Description ==
In the package description you can find some useful information, like a short description of the package, a link to the original website, a list of files contained, and more. The package description can be accessed at the url {{{http://packages.debian.org/<package-name>}}}. Or, try "aptitude show $PKG" (you may need to "apt-get update && apt-get aptitude && aptitude update" first).
Line 25: Line 110:
The most famous for Debian users are :
 * The Installation Guide ~-[[BR]]. [http://www.debian.org/doc/user-manuals#install][[BR]]. (or development version, available at [http://d-i.alioth.debian.org/manual/]-~
 * The Release Notes ~-[[BR]]. [http://www.debian.org/doc/user-manuals#relnotes]-~
 * The Debian reference ~-[[BR]]. [http://www.debian.org/doc/user-manuals#quick-reference]-~
One of the best places to look for help for a single package or application is to read stuff in {{{/usr/share/doc/<package-name>}}} (especially README.Debian). This is documentation written by developers or package maintainers. It is quite concise, but usually mentions most common problems and solutions, and new features and fixed bugs.
Line 30: Line 112:
Many other Debian Documentation are available at [http://www.debian.org/doc www.debian.org/doc]

At the moment, Debian don't have a ''System Administrtor'' manual. However, there are some books about Debian, see: [http://www.debian.org/doc/books www.debian.org/doc/books].
== Bug tracking system ==
Many problems' solutions can be found as bug report responses. A search engine for bug reports is found on http://bugs.debian.org. Remember that if you want to search in archived (quite old) bugs you must chose "archived bugs" option. If you want to look at bugs of a specific package use {{{http://bugs.debian.org/<package-name>}}}.
Line 35: Line 116:
Most documentation for Debian-developer (and package maintainer) are available from [http://www.debian.org/devel/ www.debian.org/devel/] <<Anchor(contribute)>>
= Contribute to the documentation =
Line 37: Line 119:
 {i} This is free software, __you can contribute improvements to the existing documentation__ ~-<<BR>>''(i.e. you don't have to write your own !HowTo!)''-~.
Line 38: Line 121:
[[Anchor(contribute)]]
== Contribute to documentation ==
If you are interested in contributing to documentation, please check the following resources first, to get some feel for how other people contribute:
 * http://www.debian.org/doc/ddp (most of the Debian Documentation is available here)
 * https://wiki.debian.org/ (Join this wiki and add new contents/translations)
 * http://lists.debian.org/debian-www/recent ([[DebianMailingLists|mailing-list]])
 * http://lists.debian.org/debian-doc/recent ([[DebianMailingLists|mailing-list]])
Line 41: Line 127:
Most of the Debian Documentation is available at http://www.debian.org/doc/ddp  {i} Some documentation contents are generated from the corresponding Debian package. If so, you may wish to interact with the package maintainer. Sometimes, filing a bug report for that package using the [[BTS|Debian Bug Tracking System (BTS)]] is a good idea.
Line 43: Line 129:
 {i} This is free software, __you can contribute improvements to the documentation__ ~-[[BR]]''(i.e you don't have to write your own Howto !)''-~. If you are interested in participating in the debian-doc group, please see the [[Teams/DDP|team page on the Wiki]]
Line 48: Line 135:

= See also =

 * [[DebianResources]]

Translation(s): English - Français - Italiano - Português (Brasil)


Debian is a GNU/Linux distribution, made of thousands of free software packages.

This page is about official Debian Documentation.

There are other Debian Resources

Debian Documentation

For users

The most famous for Debian users are :

Many other Debian Documentation are available at www.debian.org/doc

At the moment, Debian doesn't have a System Administrator manual.

For contributors

The most famous for Debian contributors are :

Most documentation for Debian-developer (and package maintainer) are available from www.debian.org/devel/.

Official Websites of the Debian Project

The Debian Project has a constitution and an organizational structure

On Debian.org the official Debian site, you can find a section dedicated to documentation.

Forum

Advocacy, developers, inside information

Wiki

Debian-related wikis:

Books

Many free and non-free books are listed on Debian website.

Extra books could be listed below.

Instant Messaging

There are official Debian IRC channels.

You can also use Jabber

Program documentation

Each software provides has its own documentation.

Under Debian (Unix), a program's documentation typically consist of (one or more of):

  • A manpage (type man followed by a command name).

  • A README file, provided by upstream. (A text file located at /usr/share/doc/pkgname/README)

  • A README.Debian file, provided by the Debian package maintainer. (A text file located at /usr/share/doc/pkgname/README.Debian)

  • Programs with a graphical user interface (Gnome, KDE...) usually comes with help page (accessible through Menu > Help).

  • Some program provide their documentation as html, or info page.

Package Description

In the package description you can find some useful information, like a short description of the package, a link to the original website, a list of files contained, and more. The package description can be accessed at the url http://packages.debian.org/<package-name>. Or, try "aptitude show $PKG" (you may need to "apt-get update && apt-get aptitude && aptitude update" first).

One of the best places to look for help for a single package or application is to read stuff in /usr/share/doc/<package-name> (especially README.Debian). This is documentation written by developers or package maintainers. It is quite concise, but usually mentions most common problems and solutions, and new features and fixed bugs.

Bug tracking system

Many problems' solutions can be found as bug report responses. A search engine for bug reports is found on http://bugs.debian.org. Remember that if you want to search in archived (quite old) bugs you must chose "archived bugs" option. If you want to look at bugs of a specific package use http://bugs.debian.org/<package-name>.

Contribute to the documentation

  • {i} This is free software, you can contribute improvements to the existing documentation
    (i.e. you don't have to write your own HowTo!)
    .

If you are interested in contributing to documentation, please check the following resources first, to get some feel for how other people contribute:

If you are interested in participating in the debian-doc group, please see the team page on the Wiki

See also