Update documentation

Complete and format the Rust documentation to ensure the autogenerated documentation includes comprehensive information, especially for public methods, traits, structs, and storage. This will allow downstream developers to refer directly to the documentation without needing to browse the code.

• Incode pallet description: Delete the readme and include pallet documentation directly in the code (another solution would have been #![doc = include_str!("../README.md")], but it is impractical when displaying the source code from the documentation using the "source" tag).
• Document every type.
• Document every storage.
• Document every trait.
• Document every public method.
• Fix #240 (closed).

docs/api/runtime-calls.md

@@ -812,7 +812,7 @@ Transfer some liquid free balance to another account, in milliUD.
 
 <details><summary><code>create_identity(owner_key)</code></summary>
 
-Taking 0.0912 % of a block.
+Taking 0.0914 % of a block.
 
 ```rust
 owner_key: T::AccountId
@@ -830,7 +830,7 @@ The origin must be allowed to create an identity.
 
 <details><summary><code>confirm_identity(idty_name)</code></summary>
 
-Taking 0.0338 % of a block.
+Taking 0.0339 % of a block.
 
 ```rust
 idty_name: IdtyName
@@ -869,7 +869,7 @@ The origin should be the old identity owner key.
 
 <details><summary><code>revoke_identity(idty_index, revocation_key, revocation_sig)</code></summary>
 
-Taking 0.0416 % of a block.
+Taking 0.0417 % of a block.
 
 ```rust
 idty_index: T::IdtyIndex
@@ -2261,7 +2261,7 @@ O(P) where P is the number of max proposals
 
 <details><summary><code>prune_item_identities_names(names)</code></summary>
 
-Taking 6.0421 % of a block.
+Taking 6.0424 % of a block.
 
 ```rust
 names: Vec<IdtyName>