Update docs (things have changed in the meantime)

1 files changed, 48 insertions, 42 deletions

diff --git a/doc/translations.txt b/doc/translations.txt
index 4ea383b1a..39fdb92a6 100644
--- a/doc/translations.txt
+++ b/doc/translations.txt
@@ -2,7 +2,8 @@ Debian Installation Guide - notes for translation
 --------------------------------------------------
 
 !!! Please note, that this file mostly documents xml-based
-!!! translations. This is, however, no longer supported.
+!!! translations. This is, however, no longer supported and therefore this
+!!! file is partly of-out-date.
 !!! Thus, some of the scripts mentioned below no longer work as expected!
 !!! You can now translate this manual via po files.
 !!! This is documented in the file translations_po.txt in this directory.
@@ -11,19 +12,63 @@ Debian Installation Guide - notes for translation
 Note: if you happen to modify this file, please don't forget to
       update the trailing changelog
 
+
 Where is the manual kept?
 =========================
 
 The manual is kept in a git repository on salsa.debian.org
-as part of the Debian Installer (d-i) project.
+as part of the Debian Installer (d-i) project (under
+https://salsa.debian.org/installer-team/installation-guide).
 
-The manual and its translations can be found in ./installation-guide.
+The translations can be found in ./po.
 
 Use
 'git clone git@salsa.debian.org:installer-team/installation-guide.git'
 to checkout the sources with git.
 
 
+How to get write access to the git repository
+=============================================
+
+  1) Installing git
+  ------------------------
+
+  You need to install subversion on your system. Just do
+     apt install git
+  
+  2) Getting write access to the git repository
+  ----------------------------------------------------
+
+  If you are not a Debian Developer, you first need to create a guest account
+  on https://salsa.debian.org/, than ask on debian-boot@lists.debian.org
+  for somebody to add your guest account to the debian-installer project.
+ 
+  3) Using git to get files
+  --------------------------------
+
+  Once your account is allowed to write to the project, you can retrieve the
+  installation-guide using this:
+    git clone git@salsa.debian.org:installer-team/installation-guide.git
+
+  4) Commit your changed translation files to git
+  -----------------------------------------------
+
+  After you have finished editing your translation, use
+    git add path-to-file(s)
+    git commit -m "Your comment about this commit"
+    git push
+  to commit your changes to the git repository.
+
+
+How to get help
+===============
+
+If you need further assistance, feel free to ask for help on
+debian-boot (for debian-installer related stuff) or debian-i18n (for
+l10n related questions) Debian mailing lists.
+
+
+
 How to join the translation effort for an existing translation
 ==============================================================
 
@@ -224,45 +269,6 @@ You can also try to build the manual (create HTML pages) for a specific
 architecture for your language.
 See ./build/README for more information on building the manual.
 
-How to get write access to the git repository
-=============================================
-
-  1) Installing git
-  ------------------------
-
-  You need to install subversion on your system. Just do
-     apt install git
-  
-  2) Getting write access to the git repository
-  ----------------------------------------------------
-
-  If you are not a Debian Developer, you first need to create a guest account
-  on https://salsa.debian.org/, than ask on debian-boot@lists.debian.org
-  for somebody to add your guest account to the debian-installer project.
- 
-  3) Using git to get files
-  --------------------------------
-
-  Once your account is allowed to write to the project, you can retrieve the
-  installation-guide using this:
-    git clone git@salsa.debian.org:installer-team/installation-guide.git
-
-  4) Commit your changed translation files to git
-  -----------------------------------------------
-
-  After you have finished editing your translation, use
-    git add path-to-file(s)
-    git commit -m "Your comment about this commit"
-    git push
-  to commit your changes to the git repository.
-
-
-How to get help
-===============
-
-If you need further assistance, feel free to ask for help on
-debian-boot (for debian-installer related stuff) or debian-i18n (for
-l10n related questions) Debian mailing lists.
 
 --------------------------------------------------------------------------