From ed7245277978646b828cf9cb0019d3e5bddd4d36 Mon Sep 17 00:00:00 2001
From: Frederick Muriuki Muriithi
Date: Tue, 8 Sep 2026 11:19:32 -0500
Subject: Improve page copy.

---
 .../templates/populations/view-population.html     | 35 ++++++++++++++--------
 1 file changed, 22 insertions(+), 13 deletions(-)

diff --git a/uploader/templates/populations/view-population.html b/uploader/templates/populations/view-population.html
index 29add29..6da4cd7 100644
--- a/uploader/templates/populations/view-population.html
+++ b/uploader/templates/populations/view-population.html
@@ -4,7 +4,7 @@
 
 {%block contents%}
 <div class="row">
-  <h2 class="heading">{{population.FullName}} ({{population.Name}})</h2>
+  <h2 class="heading">Population: {{population.FullName}} ({{population.Name}})</h2>
 </div>
 
 <div class="row">
@@ -58,14 +58,18 @@
          aria-labelledby="samples-content-tab">
       <p>Think of a <strong>"sample"</strong> as say a single case or individual
         in the experiment. It could even be a single strain (where applicable).
+        These are, effectively, identifiers for the organisms (plants, animals,
+        etc) that your data is collected from, and is about.
       </p>
-      <p>This is a convenience feature for when you want to upload phenotypes to
-        the system, but do not have the genotypes data ready yet.</p>
+
+      <p>The samples should be uploaded before any of the other types of data
+        (genotype, phenotype, expression, etc.), or be bundled together with
+        them, since they all need references to the samples.</p>
       <a href="{{url_for('species.populations.samples.list_samples',
                species_id=species.SpeciesId,
                population_id=population.Id)}}"
          title="View and upload samples for population '{{population['Name']}}'"
-         class="btn btn-primary">Manage Samples</a>
+         class="btn btn-primary">manage samples</a>
     </div>
 
     <div class="tab-pane fade show active"
@@ -74,9 +78,11 @@
          aria-labelledby="phenotypes-content-tab">
 
       <div class="row" style="margin-top: 1em;">
-        <h3> Phenotypes in  Population "{{population.FullName}} ({{population.Name}})"</h3>
-
-        <p>To view existing phenotype traits, or upload new ones, click the button below:</p>
+        <p>Phenotype data measures the actual observable traits or
+          characteristics of an organism e.g. physical appearance, biochemical
+          properties, development, behaviour and/or disease states.</p>
+        <p>This section enables you to view existing and/or upload new phenotype
+          data.</p>
 
         <div class="row">
           <div class="col">
@@ -85,7 +91,7 @@
                      species_id=species.SpeciesId,
                      population_id=population.Id)}}"
                title="View and upload phenotype traits"
-               class="btn btn-primary">Phenotypes</a>
+               class="btn btn-primary">manage phenotypes</a>
           </div>
         </div>
       </div>
@@ -95,17 +101,20 @@
          id="genotypes-content"
          role="tabpanel"
          aria-labelledby="genotypes-content-tab">
-      <p>Click the button to view and manage genetic data for individuals in
-        this population.</p>
-      <a href="{{url_for('species.populations.genotypes.list_genotypes',
+      <p>Genotype data records specific genetic variations (e.g. single
+        nucleotide polymorphisms (SNPs)) present at particular locations in an
+        individual's (see "Samples" section) DNA.</p>
+      <p>Click the button below to view existing and/or upload new genotype data
+        for this population.</p>
+      <a href="{{url_for('species.populations.genotypes.index',
                species_id=species.SpeciesId,
                population_id=population.Id)}}"
          title="Upload genotype information for the '{{population.FullName}}' population of the '{{species.FullName}}' species."
          class="btn btn-primary">manage genotypes</a>
     </div>
     <div class="tab-pane fade" id="expression-data-content" role="tabpanel" aria-labelledby="expression-data-content-tab">
-      <p>Upload expression data (mRNA data) for this population.</p>
-      <a href="#" title="" class="btn btn-primary">upload genotypes</a>
+      <p>Expression data is data measuring how much genes are turned on or active.</p>
+      <a href="#" title="" class="btn btn-primary">manage expression data</a>
     </div>
   </div>
 </div>
-- 
cgit 1.4.1