WIP: new structure and layout (finished up to section "Contributing")

1 files changed, 76 insertions, 38 deletions

diff --git a/english/devel/join/index.wml b/english/devel/join/index.wml
index 804e4c99f5e..8c2e5dbe551 100644
--- a/english/devel/join/index.wml
+++ b/english/devel/join/index.wml
@@ -1,40 +1,77 @@
-#use wml::debian::template title="How You Can Join"
-
-<p>The Debian Project consists of volunteers, and our products are developed
-entirely by volunteers. We are generally <a href="$(HOME)/intro/diversity">looking for new contributors</a> who have an interest in free software, and some free
-time.</p>
-
-<p>If you haven't already, you should read through most of the web pages
-to get a better understanding of what we are trying to do.
-Pay particular attention to the
-<a href="$(HOME)/social_contract#guidelines">Debian Free Software Guidelines</a>
-and our
-<a href="$(HOME)/social_contract">Social Contract</a>.</p>
-
-<p>A lot of communication in the project happens on our 
-<a href="$(HOME)/MailingLists/">mailing lists</a>.
-If you want to get a feeling for the inner workings of the Debian project,
-you should at least subscribe to the debian-devel-announce and debian-news
-lists. Both are very low-volume and document what's going on in the
-community. The Debian Project News (published on debian-news) summarizes
-recent discussions from Debian related mailing lists and blogs and provides
-links to them.
-As a prospective developer, you should also subscribe to debian-mentors,
-an open forum trying to help new maintainers (and also, though less often,
-people who are new to the Project and want to help with something else
-than package maintenance).
-Other interesting lists are debian-devel, debian-project, debian-release,
-debian-qa and, depending on your interests, a lot of others. See the
-<a href="$(HOME)/MailingLists/subscribe">Mailing List Subscription</a> page
-for a complete listing.
-(For those who wish to reduce the number of mails, there are "-digest"
-lists as read-only, digestified versions for some high-traffic lists.
-It's also worth knowing that you can use the
-<a href="https://lists.debian.org/">Mailing List Archives</a> page 
-to read the mails on various lists with your web browsers.)</p>
-
-<p><b>Contributing.</b>
-If you are interested in maintaining packages, then you should look at
+#use wml::debian::template title="How to join Debian" MAINPAGE="true"
+#use wml::debian::recent_list
+
+<link href="../devel.css" rel="stylesheet" type="text/css">
+<link href="../font-awesome.css" rel="stylesheet" type="text/css">
+
+<aside>
+<p><span class="fas fa-caret-right fa-3x"></span> We are always looking for new contributors and volunteers. We strongly encourage <a href="$(HOME)/intro/diversity">participation by everyone</a>. Requirements: interest in Free Software and some free time.</p>
+</aside>
+
+<ul class="toc">
+<li><a href="#reading">Reading</a></li>
+<li><a href="#contributing">Contributing</a></li>
+<li><a href="#joining">Joining</a></li>
+</ul>
+
+
+<h2><a id="reading">Reading</a></h2>
+
+<p>
+If you haven't already, you should read the sites linked on the <a
+href="$(HOME)">Debian start page</a>. This will help you to get a better
+understanding of who we are and what we're trying to accomplish. As a
+potential Debian contributor, please pay particular attention to these
+two pages:
+</p>
+
+<ul>
+  <li><a href="$(HOME)/social_contract#guidelines">Debian Free Software Guidelines</a></li>
+  <li><a href="$(HOME)/social_contract">Debian Social Contract</a></li>
+</ul>
+
+<p>
+A lot of our communication happens on the Debian <a
+href="$(HOME)/MailingLists/">mailing lists</a>. If
+you want to get a feeling for the inner workings of
+the Debian project, you should at least subscribe to <a
+href="https://lists.debian.org/debian-devel-announce/">debian-devel-announce</a>
+and <a href="https://lists.debian.org/debian-news/">debian-news</a>. Both
+lists are low-volume and document what's going on in the community. The
+<a href="https://www.debian.org/News/weekly/">Debian Project News</a>,
+also published on the debian-news list, summarizes recent discussions
+from Debian-related mailing lists and blogs and provides links to them.
+</p>
+
+<p>
+As a prospective developer, you should also subscribe to <a
+href="https://lists.debian.org/debian-mentors/">debian-mentors</a>. Here
+you can ask questions about packaging and infrastructure projects as
+well as other developer-related issues. Please note that this list is
+meant for new contributors, not users. Other interesting lists are <a
+href="https://lists.debian.org/debian-devel/">debian-devel</a>
+(technical development topics), <a
+href="https://lists.debian.org/debian-project/">debian-project</a>
+(discussions about non-technical issues in the project), <a
+href="https://lists.debian.org/debian-release/">debian-release</a>
+(coordinating Debian releases), <a
+href="https://lists.debian.org/debian-qa/">debian-qa</a> (quality
+assurance).
+</p>
+
+<p style="text-align:center"><button type="button"><span class="fas fa-envelope fa-2x"></span> <a href="$(HOME)/MailingLists/subscribe">Mailing List Subscription</a></button></p>
+
+<p>
+<strong>Tip:</strong> If you want to reduce the number of mails you
+receive, especially on high-traffic lists, we offer email digests. This
+way you can read a summary email instead of individual messages.
+You can also visit the <a href="https://lists.debian.org/">Mailing List
+Archives</a> page to read the messages of our lists in your web browser.
+</p>
+
+<h2><a id="contributing">Contributing</a></h2>
+
+<p>If you are interested in maintaining packages, then you should look at
 our <a href="$(DEVEL)/wnpp/">Work-Needing and Prospective Packages</a> list to see
 which packages need maintainers. Taking over an abandoned package is the
 best way to start out as a maintainer &ndash; not only does it aid
@@ -65,8 +102,9 @@ places to find package sponsors. So find a team that suits your
 interests and jump right in.
 </p>
 
+<h2><a id="joining">Joining</a></h2>
+
 <p>
-<b>Joining.</b>
 After you have contributed for some time and are sure about your involvement
 in the Debian project, you can join Debian in a more official role. There
 are two different roles in which you might join Debian: