diff --git a/.gitattributes b/.gitattributes
new file mode 100644
index 0000000..83f00da
--- /dev/null
+++ b/.gitattributes
@@ -0,0 +1,2 @@
+* text=auto
+README.md merge=union
diff --git a/README.md b/README.md
index 9ebc195..92c884a 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,93 @@
+# Awesome Semantic Shapes [![Awesome](https://awesome.re/badge.svg)](https://awesome.re)
 
-# Specification 'awesome-semantic-shapes'
+A curated list of Semantic Shapes resources.
 
-This is the repository for awesome-semantic-shapes. You're welcome to contribute! Let's make the Web rock our socks
-off!
+Contributions welcome! Please, read the [Contribution Guidelines](CONTRIBUTING.md) first.
+
+## Contents
+
+- [SHACL Validators](#shacl-validators)
+- [ShEx Validators](#shex-validators)
+- [Shapes Discovery Tools](#shapes-discovery-tools)
+- [Shapes Collections](#shapes-collections)
+- [Shape Conversion Tools](#shape-conversion-tools)
+- [Shape Generators](#shape-generators)
+- [Shape Editors, Visualizations](#shape-editors-visualizations)
+- [Declarative UIs](#declarative-uis)
+- [Book](#book)
+- [Tutorials](#tutorials)
+- [Presentations](#presentations)
+- [Specifications](#specifications)
+
+## SHACL Validators
+
+About this section. Optional. Keep this short and focus on the list.
+
+- [TopBraid SHACL API](https://github.com/TopQuadrant/shacl) -- Java, based on Jena, supports: SHACL Core, SHACL-SPARQL, SHACL rules
+- [Jena SHACL](https://github.com/apache/jena/) -- Java, Supports: SHACL Core, SHACL-SPARQL
+- [RDF4J SHACL Sail](https://github.com/eclipse-rdf4j/rdf4j) -- Java
+- [TopBraid SHACL API Extended](https://github.com/SHACL-X/shacl-x) -- Java, fork of TopBraid SHACL API + added SHACL-JS based on GraalVM Polyglot
+
+## ShEx Validators
+
+- [shexSpec/shex.js](https://github.com/shexjs/shex.js) -- JS, [playground](http://rawgit.com/shexSpec/shex.js/master/doc/shex-simple.html)
+- [ShEx-validator](https://github.com/HW-SWeL/ShEx-validator) -- JS
+- [Validata](https://github.com/HW-SWeL/Validata) -- JS, [playground](http://hw-swel.github.io/Validata/), [playground](https://www.w3.org/2015/03/ShExValidata/)
+- [Apache Jena ShEx](https://jena.apache.org/documentation/shex/index.html) -- Java
+
+## Shapes Discovery Tools
+
+- [Shapes of You index](https://index.semanticscience.org/) -- SPARQL queries, OWL/SKOS vocabularies, SHACL/ShEx shapes indexed from public git repositories.
+- [RDFminer](https://github.com/Wimmics/RDFminer) -- Web application to automatically discovering SHACL shapes representative of an RDF data graph, by Wimmics
+- [SHACL Discovery Service](https://github.com/AKSW/discover-shacl-shapes)
+
+## Shapes Collections
+
+- [schema.org Shapes](http://datashapes.org/schema) -- Schema.org, converted to SHACL by TopQuadrant
+
+## Shape Conversion Tools
+
+- [ShacShifter](https://github.com/AKSW/ShacShifter) -- "shape shifter" from SHACL to other formats (currently RDForms)
+
+## Shape Generators
+
+- [owl2shacl](https://github.com/sparna-git/owl2shacl) -- OWL 2 SHACL conversion rules
+
+## Shape Editors, Visualizations
+
+- [Allotrope Shape Editor](https://gitlab.com/allotrope-open-source/shape-editor)
+
+## Declarative UIs
+
+Data viewers/Editors based on shapes.
+
+- [shaperone](https://forms.hypermedia.app) -- SHACL Shapes Form generator
+
+## Book
+
+- [Validating RDF Data (2018)](https://book.validatingrdf.com/) 
+
+## Tutorials
+
+- [Shapes applications and tools - ISWC'20 Tutorial](https://www.validatingrdf.com/tutorial/iswc2020/)
+
+## Presentations
+
+## Specifications
+
+- SHACL, W3C Recommendations & Notes
+  - [Shapes Constraint Language (SHACL)](https://www.w3.org/TR/shacl/) -- W3C Recommendation, 20 July 2017
+  - [SHACL Advanced Features](https://www.w3.org/TR/shacl-af/) -- W3C Working Group Note, 08 June 2017
+  - [SHACL JavaScript Extensions](https://www.w3.org/TR/shacl-js/) -- W3C Working Group Note, 08 June 2017
+  - [SHACL Test Suite and Implementation Report](https://w3c.github.io/data-shapes/data-shapes-test-suite/) -- W3C Document 17 January 2024
+  - [SHACL Use Cases and Requirements](https://www.w3.org/TR/shacl-ucr/) -- W3C Working Group Note 20 July 2017
+- SHACL, Community Group Latest Drafts & Notes
+  - [SHACL 1.2 Core](https://w3c.github.io/shacl/shacl-core/)
+  - [SHACL 1.2 SPARQL Extensions](https://w3c.github.io/shacl/shacl-sparql/)
+  - [SHACL Advanced Features 1.1](https://w3c.github.io/shacl/shacl-af/)
+  - [SHACL Compact Syntax](https://w3c.github.io/shacl/shacl-compact-syntax/)
+  - [SHACL JavaScript Extensions](https://w3c.github.io/shacl/shacl-js/)
+- ShEx
+  - [Shape Expressions Language 2.1](https://shex.io/shex-semantics/index.html) -- Final Community Group Report 8 October 2019
+- ShEx, Drafts
+  - [P3330TM/D3 Draft Recommended Practice for Standard for Shape Expression Schemas](https://shexspec.github.io/spec/)