intro: adding a toggled additional info section

To not overload the page with a lot of information some additional
information that is mostly only useful for new or not very experienced
users is "hided" within a section that is toggled off by default. The
user need to click on the extra new added button to make the section
visible.

1 files changed, 113 insertions, 22 deletions

diff --git a/english/download/index.wml b/english/download/index.wml
index 4874217d6e2..a95c05b029a 100644
--- a/english/download/index.wml
+++ b/english/download/index.wml
@@ -3,32 +3,123 @@
 
 <link href="download.css" rel="stylesheet" type="text/css">
 <link href="hint.css" rel="stylesheet" type="text/css">
+<link href="toggle.css" rel="stylesheet" type="text/css">
 
-<h4>Welcome to the quick download site for installation and LiveCD images!</h4>
-  <p>There are multiple ways to get the various types of images Debian is providing.
-    The main goal of this site is providing easy to use download links for the 
-    images that have users mostly downloaded from Debian. There is a big chance
-    you will find here your wanted image directly without further steps.</p>
-  <p>We provide all kinds of installation images, supporting installation and use
-    on many types of system: laptops, desktops and servers.</p>
-  <p>And we also have created so called live images that you can run Debian on your
-    computer directly for testing without having to install it first.</p>
-    
-## translators: the following <div> paragraph about non-free is taken from
-## /english/releases/stretch/debian-installer/index.wml
-
-<div id="firmware_nonfree" class="warning">
-<p>
-If any of the hardware in your system <strong>requires non-free firmware to be
-loaded</strong> with the device driver, you can use one of the
-<strong>unofficial</strong> images including these <strong>non-free</strong> firmwares.
-</p>
+<div align="center">
+  <h4>Welcome to the download site for installation and LiveCD images!</h4>
+</div>
+<p>There are multiple ways to get the various types of images Debian is providing.
+  The main goal of this site is providing easy to use download links for the 
+  images that have users mostly downloaded from Debian. There is a big chance
+  you will find here your wanted image directly without further steps.</p>
+<p>We provide all kinds of installation images, supporting installation and use
+  on many types of system: laptops, desktops and servers.</p>
+<p>And we also have created so called live images that you can run Debian on your
+  computer directly for testing without having to install it first.</p>
+<div class="tip">
+  <p>If you searching for other types of images and can not find them here by direct
+    links please read the information at the bottom of the download section.</p>
 </div>
 
-  <div class="tip">
-    <p>If you searching for other types of images and can not find them here by direct
-      links please read the information at the bottom of the download section.</p>
+<input id="dl-additional-info" class="toggle" type="checkbox">
+<label for="dl-additional-info" class="lbl-toggle hint--right hint--info"
+       data-hint="Click here to get some further information about the details
+                  on the images in general.">Show more info...</label>
+
+<!-- Toggled / collapsed section with additional information especially for Newbies --> 
+<div class="collapsible-content">
+  <div align="center">
+    <h3>Additional Info</h3>
+      <div class="centered-middle-50 centered-middle-50-none-list">
+        <p><em><strong>Provided image types - official vs. non official images</strong></em></p>
+        <ul class="centered-middle-50-none-list">
+          <li>The Debian Developers are required to follow the rules of the
+            <a href="$(HOME)/social_contract#guidelines">Debian Free Software
+            Guidelines (DFSG)</a>!<br/>
+            This mean that all installation images, no matter on the supported
+            platform or architecture, need to be made and created only based on
+            free software that is based on the ground of the DFSG.</li>
+          <li>Unfortunately quite a lot of manufactures of PC hardware (e.g.
+            CPUs, NICs or video cards) are requiring the usage of a firmware blobs
+            to make the hardware work as expected.</li>
+          <li>Given such firmware files are pre-compiled binaries with no official
+            accessible source code makes them closed source (by the DFSG).
+            This also means that such files <strong>can't</strong> be part of any
+            official Debian installation image and are excluded.</li>
+          <li>The Debian developers are aware that all official installation
+            images can cause problems while the installation process or will
+            mostly create an not fully working Debian installation if no further
+            steps and precautions are made.</li>
+          <li>Because of this circumstance there are also images provided which
+            does include such required firmware files for getting fully functional
+            hardware. They are all have an additional suffix <em><strong>non-free</em></strong>
+            as they include non-free parts from a view of the DFSG. Because such
+            images violating the DFSG they can't be an official Debian image and
+            the Debian project is marking them as <strong>non official</strong>
+            images.</li>
+          <li>Even if the images marked as non official you are not alone if you
+            want or need to use them! The Debian support channels will provide help
+            to you if required.</li>
+          <li>New users to Debian should choose such an non-free image for better
+            first timer user experience!</li>
+        </ul>
+        ## translators: The following <div> paragraph about non-free is taken from
+        ## /english/releases/<current_stable_release>/debian-installer/index.wml
+        ## but got a bit modified.
+        <div class="tip">
+          <p><em><strong>Summary:</strong></em><br/>
+            If any of the hardware in your system <strong>requires</strong> non-free
+            firmware to be loaded with the device driver, you probably want to use
+            one of the <strong>unofficial</strong> images including these
+            <strong>non-free</strong> firmwares.</p>
+        </div>
+
+        <p><em><strong>Supported architectures and platforms</strong></em></p>
+        <ul class="centered-middle-50-none-list">
+          <li>Debian can be used on various platforms that are based on different
+            CPU architectures and we build images for almost all of them. The probably
+            most used platform in Debian today is named
+            <a href="https://en.wikipedia.org/wiki/X86-64">amd64</a> (started in
+            2000) and even hardware that was bought not recently will be build up
+            by this platform. So even if your are unsure about your local
+            machine you mostly can simply grab an image build for this platform.</li>
+          <li>Another platform that might be interesting for you is called in Debian
+            i386. The importance of this platform has decreased rapidly over the
+            past years, some other distributions have dropped the support already.
+            In case you are required to use an image for that platform please use
+            one of the buttons for more downloads further down.</li>
+          <li>Each release of Debian is supporting a lot of various other hardware
+            architectures than the Intel based. For the current Debian <current_release_name>
+            release there are also images available for a list of the architectures
+            that Debian is calling than Release Critical platforms. The release
+            team is deciding which platform will be part of this list for a stable
+            release. A platform which is called release critical will get security
+            support for the whole live span of a release!</li>
+          <li>
+            Debian is providing images not only for the release critical platforms,
+            all platforms are called <a href="$(HOME)/ports/">ports</a> within the
+            Debian universe.</li>
+        </ul>
+        <div class="tip">
+          <p><em><strong>Summary:</strong></em><br/>
+            If you need a image that is for another platform than
+            <strong>amd64</strong> please use one of the buttons for more images.
+            For the Debian <current_release_name> release the full supported
+            architectures/platforms are
+            <a href="$(HOME)/ports/i386/">i386</a>,
+            <a href="$(HOME)/ports/amd64/">amd64</a>,
+            <a href="$(HOME)/ports/arm/">arm64, armel, armhf</a>,
+            <a href="$(HOME)/ports/mips/">mips, mips64el</a>,
+            <a href="$(HOME)/ports/mips64el/">mips64</a>,
+            <a href="$(HOME)/ports/powerpc/">ppc64el</a> and
+            <a href="$(HOME)/ports/s390x/">390x</a>,
+            you will find various kind of images for these architectures.</p>
+        </div>
+    </div>
   </div>
+</div>
+<!-- End of toggled section -->
+
 <div class="line">
   <!-- 1.1 - Download, the two installer images variants -->
   <div align="center">