docs: Relates to #578 Minor fixes to documentation section in Readme (#992)

* docs: Fix syntax for module comment. Rename to substrate Core

* docs: Reorder package layers in order of level of abstraction

* docs: Make text more concise

* docs: Add SRML abbreviation