Work in progress, starts with new layout

1 files changed, 18 insertions, 17 deletions

diff --git a/english/doc/vcs.wml b/english/doc/vcs.wml
index 452aab1fc88..eb68fd600ed 100644
--- a/english/doc/vcs.wml
+++ b/english/doc/vcs.wml
@@ -1,19 +1,19 @@
-#use wml::debian::ddp title="Debian Documentation Project VCS"
-#use wml::debian::toc
-
-<p>The Debian Documentation Project stores its web pages and much of the
-manual text on the Debian Salsa service at
-<strong>salsa.debian.org</strong>, which is Debian's GitLab instance.
-Please read the <a href="https://wiki.debian.org/Salsa">Salsa documentation</a>
-for more information about how this service works.
-</p>
+#use wml::debian::template title="Debian Documentation Project VCS" MAINPAGE="true"
+
+<link href="$(HOME)/font-awesome.css" rel="stylesheet" type="text/css">
+
+<ul class="toc">
+  <li><a href="#access">Accessing the Sources in Git</a></li>
+  <li><a href="#obtaining">Obtaining Push Privileges</a></li>
+  <li><a href="#updates">Automatic Update Mechanism</a></li>
+</ul>
 
-<p>Everybody can download the sources from the Salsa service. Only members of
-the Debian Documentation Project can update files.</p>
 
-<toc-display />
+<aside>
+<p><span class="fas fa-caret-right fa-3x"></span> The <a href="ddp">Debian Documentation Project</a> stores its web pages and most manuals on <a href="https://salsa.debian.org">Salsa</a>, Debian's GitLab instance. Everybody can download the sources from the Salsa service, but only DDP members have write access and can update files..</p>
+</aside>
 
-<toc-add-entry name="access">Accessing the sources in git</toc-add-entry>
+<h2><a id="access">Accessing the Sources in Git</a></h2>
 
 <p>You can use a web interface to access the files individually and
 see changes on each project at
@@ -24,6 +24,9 @@ is often a better option. You need the
 <tt><a href="https://packages.debian.org/git">git</a></tt> package on your
 own machine.</p>
 
+<p style="text-align:center"><button type="button"><span class="fas fa-book-open fa-2x"></span> <a href="https://wiki.debian.org/Salsa">Read the Salsa docs</a></button></p>
+
+
 <h3>Cloning a git repository anonymously (read-only)</h3>
 
 <p>Use this command to download all the files for one project:</p>
@@ -57,7 +60,7 @@ the <strong>manuals</strong> directory and run the command:</p>
   <code>git pull</code>
 </p>
 
-<toc-add-entry name="obtaining">Obtaining push privileges</toc-add-entry>
+<h2><a id="obtaining">Obtaining Push Privileges</a></h2>
 
 <p>Push privileges are available to anyone who wishes to participate in
 writing the manuals.  We generally request that you have submitted
@@ -75,9 +78,7 @@ href="https://salsa.debian.org/ddp-team/"><q>ddp-team</q> group</a> or
 one of its projects.
 </p>
 
-<hr />
-
-<toc-add-entry name="updates">Automatic update mechanism</toc-add-entry>
+<h2><a id="updates">Automatic Update Mechanism</a></h2>
 
 <p>The published web pages of the manual text are generated on
 www-master.debian.org as part of the regular web site rebuilding process,