#use wml::debian::ddp title="Debian Documentation Project VCS" #use wml::debian::toc
The Debian Documentation Project stores its web pages and much of the manual text on the Debian Salsa service at salsa.debian.org, which is Debian's GitLab instance. Please read the Salsa documentation for more information about how this service works.
Everybody can download the sources from the Salsa service. Only members of the Debian Documentation Project can update files.
You can use a web interface to access the files individually and
see changes on each project at
For downloading an entire manual, direct access to the git server is often a better option. You need the git package on your own machine.
Use this command to download all the files for one project:
git clone https://salsa.debian.org/ddp-team/release-notes.git
Do the same for every project you want to clone locally.
Before accessing the git server using this method you have to be granted write access to it first. Please read how to request push permission first.
Use this command to download all the files for one project:
git clone git@salsa.debian.org:ddp-team/release-notes.git
Do the same for every project you want to clone locally.
To update your local copy with any changes made by other people, enter the manuals directory and run the command:
git pull
Push privileges are available to anyone who wishes to participate in writing the manuals. We generally request that you have submitted a couple of useful patches first.
After creating your account on Salsa,
please request push privileges by clicking Request to join
on the
group or any of the specific projects under
Once your request is approved, you'll be part of either the ddp-team
group or
one of its projects.
The published web pages of the manual text are generated on www-master.debian.org as part of the regular web site rebuilding process, which happens every four hours.
The process is set up to download the latest package versions from the
archive, rebuild each manual, and install the files
in doc/manuals/
subdirectory of the web site.
The documentation files generated by the update script can be found at https://www.debian.org/doc/manuals/.
The log files generated by the update process can be found at
7doc
and is running as part of the
often
cron job).
Note that this process regenerates the /doc/manuals/
# directory. The contents of the /doc/
directory is generated
# either from webwml or from other scripts,
# such as those which extract certain manuals from their packages.