From 819edfe38fb0f130f1a2df0593c8798160b67022 Mon Sep 17 00:00:00 2001
From: Terry Truong <terry06890@gmail.com>
Date: Mon, 11 Jul 2022 16:14:22 +1000
Subject: Add more FAQs

---
 README.md                    | 11 +++++----
 src/components/HelpModal.vue | 57 ++++++++++++++++++++++++++++----------------
 2 files changed, 42 insertions(+), 26 deletions(-)

diff --git a/README.md b/README.md
index 2770a71..ebda699 100644
--- a/README.md
+++ b/README.md
@@ -9,8 +9,9 @@ framework, with [Vite](https://vitejs.dev) as the build tool. Much of
 the styling is done using [Tailwind](https://tailwindcss.com). Packages
 are managed using [npm](https://www.npmjs.com) and [Node.js](https://nodejs.org).
 
-On the server side, tree data is served and generated using Python, with packages
-managed using [Pip](https://pypi.org/project/pip). Tree data is stored using [Sqlite](https://www.sqlite.org).
+On the server side, tree data is served and generated using Python, with
+packages managed using [Pip](https://pypi.org/project/pip). Tree data is
+stored using [Sqlite](https://www.sqlite.org).
 
 ## Files
 
@@ -32,9 +33,9 @@ managed using [Pip](https://pypi.org/project/pip). Tree data is stored using [Sq
 
 ## Setup Instructions
 
-Note: Running your own version of the client and server should be
-straightforward, but generating the database will take a long time.
-More details are in backend/data/README.md.
+Note: Running your own version of the client and server should be straightforward,
+but generating the database that they use takes a long time. More details are
+in backend/data/README.md.
 
 ### Client Side
 1.  If you don't have npm or Node.js installed, you can download a Node installer from
diff --git a/src/components/HelpModal.vue b/src/components/HelpModal.vue
index b37d954..7e0b66b 100644
--- a/src/components/HelpModal.vue
+++ b/src/components/HelpModal.vue
@@ -264,7 +264,7 @@
 				</template>
 				<template #content>
 					<div :class="contentClasses">
-						<h1 class="text-lg font-bold">How Accurate is the Information?</h1>
+						<h1 class="text-lg font-bold">How accurate is the information?</h1>
 						<p>
 							This is hard to answer precisely. The datasets are from large projects with
 							many contributors, trying to track a constantly changing field of knowledge.
@@ -279,7 +279,7 @@
 						</p>
 						<ul class="list-disc pl-4">
 							<li>
-								<h2 class="font-bold">Errors in Node Linkage</h2>
+								<h2 class="font-bold">Errors in node linkage</h2>
 								<p>
 									The datasets don't share the same set of node identifiers. So, in order to
 									link nodes from one dataset with another, their plain names were used.
@@ -289,7 +289,7 @@
 								</p>
 							</li>
 							<li>
-								<h2 class="font-bold">Errors within the Datasets</h2>
+								<h2 class="font-bold">Errors within the datasets</h2>
 								<p>
 									Some issues are internal to the datasets themselves. For example, an image from
 									EOL might display a plant that is in the wrong taxon. Some of these can be
@@ -297,7 +297,7 @@
 								</p>
 							</li>
 							<li>
-								<h2 class="font-bold">Errors in Descriptions</h2>
+								<h2 class="font-bold">Errors in descriptions</h2>
 								<p>
 									The short descriptions were extracted using imprecise heuristics.
 									There are many cases of leftover wikitext markup, or cut-off sentences.
@@ -305,47 +305,62 @@
 							</li>
 						</ul>
 						<br/>
-						<h1 class="text-lg font-bold">Where are the Dogs?</h1>
+						<h1 class="text-lg font-bold">Where are the dogs?</h1>
 						<p>
 							Generally, the nodes in the tree don't go below the species level.
 							And dog breeds aren't considered separate species, but as variant
 							descendants of Canis familiaris.
 						</p>
 						<br/>
-						<h1 class="text-lg font-bold">Why is there no Tile for the Dinosaurs?</h1>
+						<h1 class="text-lg font-bold">Why is there no tile for the dinosaurs?</h1>
 						<p>
 							Some names don't correspond to a single node, but to multiple nodes
 							from different ancestors. Many dinosaurs are under Sauria, but share
 							that parent with non-dinosaurs, such as turtles.
 						</p>
 						<br/>
-						<h1 class="text-lg font-bold">Shouldn't there be more Bacteria?</h1>
+						<h1 class="text-lg font-bold">Shouldn't there be more bacteria?</h1>
 						<p>
 							Many of the bacteria don't have images, and were excluded from the default
 							Visual tree.
 						</p>
 						<br/>
-						<h1 class="text-lg font-bold">Why do some Tiles share the same Description?</h1>
+						<h1 class="text-lg font-bold">Why do some grasses share the same description?</h1>
 						<p>
-							Nodes are largely matched with Wikipedia descriptions using wiki page names.
-							So, if there are two names for which Wikipedia redirects to a shared page that
-							provides a generic description, they will both get the same description.
+							Nodes are largely matched with descriptions using Wikipedia page names.
+							And, if two names redirect to a page that provides a generic description,
+							they will both get the same description. Unfortunately, this can result in
+							two species of grass being described like a third closely-related species.
 						</p>
 						<br/>
-						<h1 class="text-lg font-bold">Some Search Suggestions are Unusual</h1>
+						<h1 class="text-lg font-bold">Why did searching for 'goat' send me to the moths?</h1>
 						<p>
-							As an example, in the Complex tree, searching for 'orange', then pressing enter,
-							brings up a kind of butterfly, instead of a citrus plant. This is because, currently,
-							suggestions are not ordered by how well-known the taxons are.
+							When you search for a name, then press enter, the first result is used.
+							Currently, search suggestions are not ordered by well-known the taxons are,
+							so the first result might mean 'Goat Moth' instead of 'Domestic Goat'.
 						</p>
 						<br/>
-						<h1 class="text-lg font-bold">Some of the Images are Weird</h1>
+						<h1 class="text-lg font-bold">Why do a lot of fish have their heads clipped out?</h1>
 						<p>
-							Selection and extraction of the images was done semi-automatically, and sometimes
-							this hasn't worked well. For example, many birds have their heads cropped out.
-							And some images were selected despite being non-ideal. Some fish are shown in a
-							preserved form that is hard to recognise. And some moths are shown alongside
-							a more prominent plant, and are hard to see.
+							Cropping images into squares was done semi-automatically, and sometimes this
+							doesn't work well, especially for animals with long bodies. It's not always
+							straightforward to figure out which end is the head, and should be kept in frame.
+						</p>
+						<br/>
+						<h1 class="text-lg font-bold">Why do some snail images just look like documents?</h1>
+						<p>
+							Not all organisms are easy to get live images of. Some of them only have
+							small parts shown, or are in a preserved form, with nearby documentation
+							appearing more prominent.
+						</p>
+						<br/>
+						<h1 class="text-lg font-bold">I'm an arachnophobe. How do I avoid spider images?</h1>
+						<p>
+							Spiders are placed under Araneae, so don't go there. You might want to avoid
+							Chelicerata in general, as it contains pseudo-spiders like harvestmen and tickspiders.
+							Actually, maybe avoid the arthropods altogether, as they include spider crabs.
+							Come to think of it, some of the bird images show them eating spiders, so maybe
+							that won't work either ...
 						</p>
 					</div>
 				</template>
-- 
cgit v1.2.3