diff --git a/README.md b/README.md
index ac490c51c03434c97ba57a75aafa0f8441f00c93..c1daa0c625ec8f3dfe3adcddebc2b19e7bb7a28d 100644
--- a/README.md
+++ b/README.md
@@ -2,6 +2,14 @@
 
 This is a collection of tools, code and examples used for converting user's modelling projects into [ModelCIF format](https://mmcif.wwpdb.org/dictionaries/mmcif_ma.dic/Index/) for upload to [ModelArchive](https://www.modelarchive.org) (MA). The whole repository has grown over time from bulk uploads to MA, we assisted users with. Do not expect everything to work out of the box, old conversion projects may be outdated by now.
 
+
+## ModelCIF resources
+
+The official documentation of [ModelCIF](https://mmcif.wwpdb.org/dictionaries/mmcif_ma.dic/Index/) and [PDBx/mmCIF](https://mmcif.wwpdb.org/dictionaries/mmcif_pdbx_v50.dic/Index/) can be found here: https://mmcif.wwpdb.org
+
+ModelCIF dictionary files can be found in the official repository: https://github.com/ihmwg/ModelCIF
+
+
 ## Directories
 
 A short overview of the directories in this repository and what they do.
@@ -11,5 +19,5 @@ A short overview of the directories in this repository and what they do.
 |projects/  |Collection of model conversions done for various user projects. |
 |validation/|A tool to check the formatting of ModelCIF files.               |
 
-<!--  LocalWords:  modelcif ModelArchive
+<!--  LocalWords:  modelcif ModelArchive PDBx
  -->
diff --git a/validation/README.md b/validation/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..697e5bbe16c0f4e881be65b9a9099dd5b0b61c23
--- /dev/null
+++ b/validation/README.md
@@ -0,0 +1,20 @@
+# ModelCIF validation tool
+
+This is a tool to check that the formatting of ModelCIF files complies with the ModelCIF format declaration (aka "dictionary"). Upon successful validation, a ModelCIF file can be extended with the dictionary version the file was compared to (option ToDo: add option). For more basic mmCIF validation, the dictionary of the underlying PDBx/mmCIF format is also available.
+
+The easiest way to run validation is from Docker container. Running it out of Docker requires an installation of [OpenStructure](https://openstructure.org).
+
+[[_TOC_]]
+
+- how to run the tool
+
+- how to run the container
+
+- how to pull the container
+
+- how to build the container
+
+- files (at the bottom)
+
+<!--  LocalWords:  PDBx
+ -->