Improved Documentation.md.

Changelog.md

@@ -6,6 +6,7 @@ Small and insignificant changes may not be included in this log.
 
 ## Unversioned Changes
 
+* Improved Documentation.md. - *Simon Sarasova*
 * Upgraded all uses of math/rand to math/rand/v2. - *Simon Sarasova*
 * Improved Whitepaper.md. Race and ancestry are now seperate concepts. - *Simon Sarasova*
 * Improved ReadMe.md and Documentation.md. - *Simon Sarasova*

Contributors.md

@@ -9,4 +9,4 @@ Many other people have written code for modules which are imported by Seekia. Th
 
 Name | Date Of First Commit | Number Of Commits
 --- | --- | ---
-Simon Sarasova | June 13, 2023 | 238
+Simon Sarasova | June 13, 2023 | 239

documentation/Documentation.md

@@ -500,9 +500,13 @@ Moderator disabled profiles must be kept in the network forever, because moderat
 
 Seekia aims to help cure racial loneliness by helping users to find mates who are racially similar to them.
 
-Seekia allows users to filter mates by traits such as eye color, skin color, hair color, and hair texture.
+Seekia allows users to filter mates by traits such as eye color, skin color, hair color, hair texture, and the alleles in their genome which effect these traits.
 
-Seekia profiles can also contain a user's genetic ancestry and trait genetics, and users can filter other users based on these attributes.
+### Ancestry
+
+Seekia is an ancestry aware mate discovery network. Users can share the ancestral populations they are descended from and the haplogroups they belong to. Users can filter other users by their ancestry, and can view the calculated ancestry of their prospective offspring with each user. Filtering and sorting by ancestry will help users to find mates who belong to their desired race(s), because ancestry is correlated to race.
+
+User profiles can include ancestral analyses from multiple providers and computational methods. The Seekia app is also planned to provide the ability to perform ancestral analyses from raw genome data files.
 
 ### Racial Similarity
 
@@ -510,7 +514,7 @@ Users are able to sort other users based on their racial similarity.
 
 Seekia aims to help people find the most racially similar person, but one who is not similar enough that their offspring would have health issues. This is a tool that is useful in Seekia's goal to cure racial loneliness.
 
-Racial similarity aims to help match people who look alike and have similar genetic sequences for physical traits. These matches are more likely to breed children who look similar to them.
+Racial similarity aims to help match people who look alike and have similar allele values in their genome which effect physical traits. These matches are more likely to breed children who look similar to them.
 
 Racial similarity is calculated by comparing trait similarity, trait genetic similarity, ancestral similarity, and haplogroup similarity.
 
@@ -520,7 +524,7 @@ To calculate trait similarity, each user's eye color, skin color, hair color, an
 
 For example, if both users have blue eyes, their Eye Color similarity is 100%.
 
-Facial similarity detection technology is a planned feature to help cure racial loneliness. The Seekia app could scan user profile photos to help users to find potential mates whom have similar physical traits.
+Facial similarity detection technology is another planned feature for Seekia. The Seekia app could compare user profile photos to help users to find potential mates whom have similar facial structures, helping to cure racial loneliness. Users could also import photos of people they are strongly attracted to for the purpose of finding a mate who looks similar to them.
 
 #### Trait Genetic Similarity
 
@@ -556,7 +560,7 @@ Each message has an Inbox, which is used by the recipient when downloading their
 
 Only Mate/Moderator users can send messages. Hosts are excluded, because I see no need at this moment for hosts to communicate over the network. Hosts can always share some other communication method such as an email address on their profile.
 
-Inter-identityType communication is forbidden. Mate users can only contact Mate users, and moderators can only contact other moderators. This rule exists to prevent Mate users from being manipulated by malicious Moderators.
+Inter-IdentityType communication is forbidden. Mate users can only contact Mate users, and moderators can only contact other moderators. This rule exists to prevent Mate users from being manipulated by malicious Moderators.
 
 ### Funding Messages
 
@@ -635,7 +639,7 @@ The Basaldata decryption key is hashed to create a Message Cipher Key.
 
 Both keys are encrypted: One with Nacl, and the other with Kyber.
 
-The basaldata decryption key cannot be derived from the message cipher key. This is done because users share the message cipher key when reporting a message. Reporters are able to reveal the contents of the message communication and the message sender without revealing the Basaldata, which contains the message recipient (generally the person making the report) and other sensitive information.
+The basaldata decryption key cannot be derived from the message cipher key. This is done because users share the message cipher key when reporting a message. Reporters are able to reveal the contents of the message communication and the message sender without revealing the Basaldata, which contains the message recipient (typically the person making the report) and other sensitive information.
 
 In cases where the recipient of the message received the message to their secret inbox, revealing the cipher key would not reveal the message recipient's identity hash. For messages sent to the recipient's public inbox, the basaldata only prevents some of the sender's metadata from being revealed.
 
@@ -675,7 +679,7 @@ The moderators provide the message cipher key with their reviews, which acts as
 
 Users download their messages by downloading the messages within their public inboxes and active secret inboxes.
 
-The client keeps a list of active secret inboxes, and checks them one-by-one from different hosts over new tor circuits to prevent hosts from linking the inboxes together.
+The client keeps a list of active secret inboxes, and checks them one-by-one from different hosts over new Tor circuits to prevent hosts from linking the inboxes together.
 
 If a user contacts 100 users during a particular secret inbox epoch, this will add 100 secret inboxes to check for the current secret inbox epoch, and 100 to check for the next epoch.