TOC

docs/sophia.md

@@ -1,12 +1,23 @@
 <!-- IMPORTANT: REMEMBER TO UPDATE THE TABLE OF CONTENTS AFTER YOUR EDIT -->
 
+# The Sophia Language
+An Æternity BlockChain Language
+
+The Sophia is a language in the ML family. It is strongly typed and has
+restricted mutable state.
+
+Sophia is customized for smart contracts, which can be published
+to a blockchain (the Æternity BlockChain). Thus some features of conventional
+languages, such as floating point arithmetic, are not present in Sophia, and
+some blockchain specific primitives, constructions and types have been added.
+
 **Table of Contents**
 
-- [-](#-)
-- [Language Features](#language-features)
+  - [Language Features](#language-features)
     - [Contracts](#contracts)
       - [Calling other contracts](#calling-other-contracts)
       - [Protected contract calls](#protected-contract-calls)
+      - [Contract factories and child contracts](#contract-factories-and-child-contracts)
     - [Mutable state](#mutable-state)
       - [Stateful functions](#stateful-functions)
     - [Payable](#payable)
@@ -37,7 +48,7 @@
       - [Example](#example)
       - [Sanity checks](#sanity-checks)
     - [AENS interface](#aens-interface)
-            - [Example](#example-1)
+      - [Example](#example)
     - [Events](#events)
       - [Argument order](#argument-order)
     - [Compiler pragmas](#compiler-pragmas)
@@ -50,7 +61,7 @@
     - [Layout blocks](#layout-blocks)
     - [Notation](#notation)
     - [Declarations](#declarations)
-        - [Types](#types-1)
+    - [Types](#types)
     - [Statements](#statements)
     - [Expressions](#expressions)
     - [Operators types](#operators-types)
@@ -58,17 +69,6 @@
   - [Examples](#examples)
     - [Delegation signature](#delegation-signature)
 
-
-## The Sophia Language
-An Æternity BlockChain Language
-
-The Sophia is a language in the ML family. It is strongly typed and has
-restricted mutable state.
-
-Sophia is customized for smart contracts, which can be published
-to a blockchain (the Æternity BlockChain). Thus some features of conventional
-languages, such as floating point arithmetic, are not present in Sophia, and
-some blockchain specific primitives, constructions and types have been added.
 ## Language Features
 ### Contracts
 
@@ -171,7 +171,7 @@ However, note that errors that would normally consume all the gas in the
 transaction still only uses up the gas spent running the contract.
 
 
-### Contract factories and child contracts
+#### Contract factories and child contracts
 
 Since the version 5.0.0 Sophia supports deploying contracts by other
 contracts. This can be done in two ways: