Improved ReadMe.md, Documentation.md, and Whitepaper.md.

Changelog.md

@@ -6,6 +6,8 @@ Small and insignificant changes may not be included in this log.
 
 ## Unversioned Changes
 
+* Improved ReadMe.md, Documentation.md, and Whitepaper.md. - *Simon Sarasova*
+* Improved Future-Plans.md. - *Simon Sarasova*
 * Upgraded go-chart to version 2.1.2. - *Simon Sarasova*
 * Upgraded Badger to version 4.3.0. - *Simon Sarasova* 
 * Upgraded Whitepaper.pdf to Version 9. - *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 | 305
+Simon Sarasova | June 13, 2023 | 307

ReadMe.md

@@ -16,7 +16,7 @@ Seekia enables users to browse and filter potential mates by their genetic attri
 
 Users can view information about the health and physical traits of their prospective offspring for each user. Users can choose to mate with users with whom their offspring has a lower probability of having diseases and a higher probability of having certain traits.
 
-Seekia aims to improve the genetic quality of humanity by making humans healthier, more beautiful, more intelligent, more virtuous, and happier. Seekia aims to facilitate eugenic breeding by helping to create mate pairings which are the most likely to produce healthy, beautiful, intelligent, virtuous, and happy offspring.
+Seekia aims to increase humanity's genetic desirability by making humans healthier, more beautiful, more intelligent, more virtuous, and happier. Seekia aims to facilitate eugenic breeding by helping to create mate pairings which are the most likely to produce healthy, beautiful, intelligent, virtuous, and happy offspring.
 
 The goal of Seekia is to accelerate humanity's adoption of genetics aware mate discovery technology, and to help humanity mate in a genetics aware manner.
 

documentation/Documentation.md

@@ -25,7 +25,7 @@ Users can analyze their genomes using the Seekia app to learn about monogenic di
 
 Users can view information about the health and physical traits of their prospective offspring for each user. Users can choose to mate with users with whom their offspring has a lower probability of having diseases and a higher probability of having certain traits.
 
-Seekia aims to improve the genetic quality of humanity by making humans healthier, more beautiful, more intelligent, more virtuous, and happier. Seekia aims to facilitate eugenic breeding by helping to create mate pairings which are the most likely to produce healthy, beautiful, intelligent, virtuous, and happy offspring.
+Seekia aims to increase the genetic desirability of humanity by making humans healthier, more beautiful, more intelligent, more virtuous, and happier. Seekia aims to facilitate eugenic breeding by helping to create mate pairings which are the most likely to produce healthy, beautiful, intelligent, virtuous, and happy offspring.
 
 The goal of Seekia is to accelerate the world's adoption of genetics aware mate discovery technology, and to help the world mate in a genetics aware manner.
 

documentation/Future-Plans.md

@@ -344,6 +344,8 @@ There are many benefits to having widely available open source genetic predictio
 
 All of this is already possible, but will become easier with the proliferation of more advanced open source genetic prediction models. Many advanced genetic prediction methods already exist, but many of them are closed source. Even using a public model trained on closed data would not be sufficient for Seekia's use case, because we need users to be confident that the models are reproducible and created from accurate data. We want the genetic future of the human species to be steered by open source technology.
 
+We can create training data by taking freely available genetic biobanks which lack phenotype data and using freely available prediction scoring methods to infer the likelihood of each phenotype for each genome. See [pgscatalog.org](https://www.pgscatalog.org/) for polygenic scoring methods. This strategy would be inferior to having the original biobank data because we would be trusting the people who provided the polygenic scoring methods, and predictions would be less accurate because we would be training on a prediction of a prediction. This strategy will likely be necessary because it will allow us to circumvent gaining access to biobank data.
+
 ### Add more diseases and traits
 
 Adding monogenic diseases entails entering disease SNP data from SNPedia.com and other sources. The bases have to be flipped if the orientation on SNPedia is minus. This requires flipping G/C and A/T. At least 3 people should check any added disease SNPs to ensure accuracy.

documentation/Whitepaper.md

@@ -20,51 +20,51 @@ We can classify humans into separate races. Races are defined by grouping humans
 
 We can also classify humans by their geographic ancestry by describing the locations where each person's ancestors lived at different times in history. Ancestry can be measured by analyzing genetic markers that a person shares with past human populations. Geographic distance was a significant impediment to gene flow between population groups for most of humanity's history. The humans within each isolated population group bred among themselves, resulting in the loss of genetic variation through the process of genetic drift. Consequently, members of these populations tend to be racially similar to each other.
 
-## Genetic Quality
+## Genetic Desirability
 
-Genetic quality is defined by humanity's collective perceptions and sentiments. We define high quality genetics as any genetic attributes which help humanity to flourish and be happy.
+Genetic desirability is defined as the degree to which humanity collectively desires particular genetic attributes. Desirable genetic attributes generally help humanity to flourish and be happy. Over time, humanity's desires should trend towards attributes which increase human happiness and wellbeing.
 
-Genetic quality is defined by four main attributes: beauty, health, intelligence, and personality. Healthy, beautiful, intelligent, happy, and virtuous people are collectively genetically superior to diseased, ugly, stupid, sad, and immoral people.
+Genetic desirability is defined by four main attributes: beauty, health, intelligence, and personality. Healthy, beautiful, intelligent, happy, and virtuous people are collectively genetically more desirable than diseased, ugly, stupid, sad, and immoral people.
 
-Certain humans are higher in genetic quality than other humans, and certain races are collectively higher in genetic quality than other races. In other words, some humans are genetically superior to other humans, and some races are collectively genetically superior to other races.
+Certain humans are more genetically desirable than other humans, and certain races are collectively more genetically desirable than other races. There does not exist a singular person or race which is the most genetically desirable, but there are humans and races which possess greater and lesser degrees of genetic desirability. A gorgeous, intelligent, witty, dazzling, healthy, kind firefighter is much more desired and loved than an ugly, diseased, schizophrenic, disabled, deceptive, rude, thieving thug. Someone in our world may prefer the thug over the firefighter, but on average, humanity prefers the firefighter's genetic traits.
 
-There does not exist a singular person or race which possesses the highest genetic quality, but there are higher and lower genetic quality humans and races. A gorgeous, intelligent, witty, dazzling, healthy, kind firefighter is much more desired and loved than an ugly, diseased, schizophrenic, disabled, deceptive, rude, thieving thug. Someone in our world may prefer the thug over the firefighter, but on average, humanity prefers the firefighter's genetic traits.
+Genetic desirability varies between populations due to cultural and environmental differences. Each population will always have a measurable set of genetic attributes which are more desired than other attributes.
 
-The world becomes a better place when it is populated with humans and races of a higher genetic quality rather than those of a lower genetic quality.
+The world becomes a better place when it is populated with humans and races of a higher genetic desirability rather than those of a lower genetic desirability.
 
 ### Beauty
 
 Human beauty is defined as the ability of a person's physical appearance to evoke feelings of sexual attraction, arousal, and pleasure in other humans. Beauty is subjective for each individual, but trends and patterns emerge when surveying large quantities of people. Human beauty ranking is calculated by comparing the sentiments expressed by large populations of humans. Some people are more beautiful than other people, and some races are collectively more beautiful than other races. Human beauty inequality is an inevitable consequence of human appearance diversity.
 
-Beauty is superior to ugliness. It is easier to reduce and obscure a person's beauty if they have too much than to increase a person's beauty if they have too little.
+Beauty is more desirable than ugliness. It is easier to reduce and obscure a person's beauty if they have too much than to increase a person's beauty if they have too little.
 
 ### Intelligence
 
 Intelligence is defined as the ability to understand information, recognize patterns, be creative, and solve problems. Intelligence is entirely derived from the brain and is thus a genetic trait, but can be influenced by a person's environment. Some humans are smarter than other humans, and some races are collectively smarter than other races. Cognitive inequality explains much of the outcome disparities between different humans and races that exist in our modern world.
 
-Intelligence is superior to stupidity. Enough intelligence would allow a person to solve any problems that are caused by intelligence. It is also easier to reduce a person's intelligence if they have too much than it is to increase a person's intelligence if they have too little.
+Intelligence is more desirable than stupidity. Enough intelligence would allow a person to solve any problems that are caused by intelligence. It is also easier to reduce a person's intelligence if they have too much than it is to increase a person's intelligence if they have too little.
 
 ### Health
 
 Health is defined as the proper functioning and well-being of the human body. Health is associated with a longer lifespan, increased mobility, and an absence of pain and illness. Some people are healthier than other people, and some races are collectively healthier than other races.
 
-Health is superior to disease. Ability is superior to disability. Pain and suffering are inherently bad and unpleasant for humans to experience.
+Health is more desirable than disease. Ability is more desirable than disability. Pain and suffering are inherently bad and unpleasant for humans to experience.
 
 ### Personality
 
-Personality is defined as a person's thought patterns, behaviors, and methods for understanding, interacting with, and experiencing the world. Personality is largely genetic. Personality and intelligence are causally connected. Some people have better personalities than other people, and some races collectively have better personalities than other races. Some examples of positive personality traits are happiness, virtue, hopefulness, empathy, calmness, compassion, sociability, generosity, cleanliness, honesty, perseverance, and kindness.
+Personality is defined as a person's thought patterns, behaviors, and methods for understanding, interacting with, and experiencing the world. Personality is largely genetic. Personality and intelligence are causally connected. Some people have more desirable personalities than other people, and some races collectively have more desirable personalities than other races. Some examples of desirable personality traits are happiness, virtue, hopefulness, empathy, calmness, compassion, sociability, generosity, cleanliness, honesty, perseverance, and kindness.
 
-Happy and virtuous personalities are superior to sad and immoral personalities. It is impossible to have an excess of happiness or virtue. Happiness is the ultimate goal of human life and is the only thing that humans desire for its own sake.
+Happy and virtuous personalities are more desirable than sad and immoral personalities. It is impossible to have an excess of virtue. An excess of happiness could be undesirable if it decreases virtue by causing complacency, thus causing unhappiness for others. Happiness and virtue are causally linked for most people. Happiness is the ultimate goal of human life and is the only thing that humans desire for its own sake.
 
 ## Eugenics
 
-Eugenics is defined as any practice or process which improves humanity's genetic quality.
+Eugenics is defined as any practice or process which improves humanity's genetic desirability.
 
-Eugenics can be observed in many different processes. Diseases which disproportionately kill weak, disabled, and obese people can improve humanity's genetics by reducing the prevalence of their inferior genes. Long periods of drought and poor weather can improve humanity's genetics by causing unintelligent people who did not stockpile enough food to die.
+Eugenics can be observed in many different processes. Diseases which disproportionately kill weak, disabled, and obese people can improve humanity's genetic desirability by reducing the prevalence of their undesirable genes. Long periods of drought and poor weather can improve humanity's genetic desirability by causing unintelligent people who did not stockpile enough food to die.
 
-The history of human evolution has been an overall eugenic process. Throughout human history, natural and human mate selection strategies have overall favored positive genetic traits such as health, intelligence, beauty, and sociability. The breeding arena of the human species is a fierce Darwinian competition with large outcome disparities. The fittest humans of the best genetic quality were able to live healthier and longer lives, attract the highest quality mates, and produce the greatest quantity of offspring. The processes of natural, artificial, and sexual selection caused the genetics of our species to improve.
+The history of human evolution has been an overall eugenic process. Throughout human history, natural and human mate selection strategies have overall favored desirable genetic traits such as health, intelligence, beauty, and sociability. The breeding arena of the human species is a fierce Darwinian competition with large outcome disparities. The fittest humans with the most desirable genetics were able to live healthier and longer lives, attract the most desirable mates, and produce the greatest quantity of offspring. The processes of natural, artificial, and sexual selection caused the genetic desirability of our species to increase.
 
-One limitation of historical human eugenic mating is that people have had to infer the genetic quality of their potential mates from each person and their relatives' outwardly visible genetic traits. Sometimes, someone may possess superior genetic traits, but will produce lower genetic quality offspring due to unexpressed genetic mutations. There are also certain mate pairings which result in lower genetic quality offspring due to incompatibilities in each mate's genome. With modern technology, we are now capable of sequencing human genomes, helping us to understanding who actually has the best genetics, and how we can pair up humans in the optimal way to improve humanity's genetics.
+One limitation of historical human eugenic mating is that people have had to infer the genetic desirability of their potential mates from each person and their relatives' outwardly visible genetic traits. Sometimes, someone may possess more desirable genetic traits, but will produce less genetically desirable offspring due to unexpressed genetic mutations. There are also certain mate pairings which result in less genetically desirable offspring due to incompatibilities in each mate's genome. With modern technology, we are now capable of sequencing human genomes, helping us to understanding who actually has the most desirable genetics, and how we can pair up humans in the optimal way to increase humanity's genetic desirability.
 
 ## Seekia
 
@@ -80,13 +80,13 @@ Seekia enables users to browse and filter potential mates by their genetic attri
 
 Users can view information about the health and physical traits of their prospective offspring for each user. Users can choose their mate in such a way to reduce the probability of their offspring having genetic diseases and increase the probability of their offspring having certain traits.
 
-Seekia aims to improve humanity's genetics by helping to create mate pairings which are the most likely to produce healthy, beautiful, intelligent, virtuous, and happy offspring.
+Seekia aims to improve humanity's genetic desirability by helping to create mate pairings which are the most likely to produce healthy, beautiful, intelligent, virtuous, and happy offspring.
 
 I will now describe an overview of the features and advantages of Seekia. The technicals of Seekia are described in greater detail in the Seekia documentation and code implementation.
 
 ## Selective Breeding
 
-Seekia aims to improve humanity's genetics by facilitating the eugenic technique of selective breeding. Selective breeding is the practice of breeding specific human pairs to produce humans of a higher genetic quality. By encouraging breeding between certain people, it is possible to increase humanity's overall beauty, health, intelligence, virtue, and happiness. This technique is akin to combining the same set of foods together to create either 5 delicious meals or 5 revolting meals.
+Seekia aims to improve humanity's genetics by facilitating the eugenic technique of selective breeding. Selective breeding is the practice of breeding specific human pairs to produce humans of a higher genetic desirability. By encouraging breeding between certain people, it is possible to increase humanity's overall beauty, health, intelligence, virtue, and happiness. This technique is akin to combining the same set of foods together to create either 5 delicious meals or 5 revolting meals.
 
 ### Beauty