From dceac7cd4951e8f8b39e2897f5633c37aa44fddc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?David=20Ord=C3=A1s?=
 <3125580+davorpa@users.noreply.github.com>
Date: Mon, 14 Feb 2022 17:35:11 +0100
Subject: [PATCH] docs(readme): fix h2-h3 heading levels (#6702)

* fix h2-h3 heading levels

* Use a more idiomatic paragraph for resources section

It helps to newcommers take a context about how to the repository is structured

Co-authored-by: CleanMachine1 <78213164+CleanMachine1@users.noreply.github.com>

* Fix a little bit an incorrect tense with the word splited and complete idiomatic paragraph

It helps to newcommers take a context about how to the repository is structured

Co-authored-by: CleanMachine1 <78213164+CleanMachine1@users.noreply.github.com>

* Reword resources paragraph to be more succintely

Co-authored-by: CleanMachine1 <78213164+CleanMachine1@users.noreply.github.com>
---
 README.md | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index ad717fce6..44d00f33b 100644
--- a/README.md
+++ b/README.md
@@ -20,12 +20,12 @@ The list was moved to GitHub by Victor Felder for collaborative updating and mai
 The [Free Ebook Foundation](https://ebookfoundation.org) now administers the repo, a not-for-profit organization devoted to promoting the creation, distribution, archiving, and sustainability of free ebooks. [Donations](https://ebookfoundation.org/contributions.html) to the Free Ebook Foundation are tax-deductible in the US.
 
 
-### How To Contribute
+## How To Contribute
 
 Please read [CONTRIBUTING](docs/CONTRIBUTING.md). If you're new to GitHub, [welcome](docs/HOWTO.md)! Remember to abide by our [Code of Conduct](docs/CODE_OF_CONDUCT.md) too. ([translations](docs/README.md#translations) also available)
 
 
-### How to Share
+## How to Share
 
 + [Share on Twitter](http://twitter.com/intent/tweet?text=https://github.com/EbookFoundation/free-programming-books%0AFree%20Programming%20Books)
 + [Share on Facebook](https://www.facebook.com/share.php?u=https%3A%2F%2Fgithub.com%2FEbookFoundation%2Ffree-programming-books&p[images][0]=&p[title]=Free%20Programming%20Books&p[summary]=)
@@ -33,6 +33,10 @@ Please read [CONTRIBUTING](docs/CONTRIBUTING.md). If you're new to GitHub, [welc
 + [Share on Telegram](https://t.me/share/url?url=https://github.com/EbookFoundation/free-programming-books)
 
 
+## Resources
+
+This project lists books and other resources grouped by genres:
+
 ### Books
 
 [English, By Programming Language](books/free-programming-books-langs.md)
@@ -157,7 +161,7 @@ Free Podcasts and Screencasts:
 + [English](more/free-programming-playgrounds.md)
 
 
-### Translations
+## Translations
 
 Volunteers have translated many of our Contributing, How-to, and Code of Conduct documents into languages covered by our lists.