Describe the plugin that exists now, in one line that survives extraction

The gallery and the plugin-studio — the surfaces a new developer or an inheritor opens to
learn what is here — described a plugin that stopped existing twenty ticks ago.
resources-map read "Every country shaded by how much of its unengaged population has NO
gospel resource": the choropleth, and nothing about the 12,379 people-group pins, the real
per-group links, the search or the gap filter. data-tables read "Two validated tables"
when there are eight. Someone browsing for a tool that maps gospel resources per people
group would not have learned that this is one.

★ AND A LONGER DESCRIPTION WOULD HAVE MADE IT WORSE. generate-tree extracts with
/^\s*\*\s*@([\w-]+)\s+(.+?)\s*$/gm — ONE LINE. A wrapped @description silently ships only
its first line, so my first rewrite ended mid-sentence on the word "and", which is worse
than the stale text it replaced. All four profiles are now a single complete sentence.

THIS IS NOT LOCAL. 27 profiles across the repo ship a description that ends mid-sentence,
including doxa-maps-spa — the flagship SPA — and big-picture, cities-internet and
all-people-groups. check:profile-descriptions asserts a description EXISTS, not that it is
a whole sentence, so all 27 pass. Fixing this bundle takes it to 23. The rest are other
bundles' and are left alone rather than failing a shared gate on work that is not mine;
the measurement is here for whoever owns them.

The gallery also had to be regenerated: it is written by `bun run gallery` from the
manifest, so updating the source docblocks moved the manifest and left the gallery HTML
stale. Both now carry the new text; verified by searching the built gallery for it.

Verified: 4 of 4 profiles in this bundle end in a full stop, the manifest carries the
complete text, the built gallery contains it, and the coverage gate, descriptions gate,
SRI check and map gate all pass.

plugin-designs/gospel-resources/charts.vue

@@ -2,8 +2,7 @@
 /**
  * charts.vue — GOSPEL RESOURCES, CHARTED BY LANGUAGE (ISO 639-3).
  *
- * @description The gap by LANGUAGE (ISO 639-3) rather than by people group — because one translation serves every
- *   group that speaks it, so language is the unit that shows where the real gap is.
+ * @description The gap measured by LANGUAGE (ISO 639-3) rather than by people group, because one translation serves every group that speaks it, so counting by group overstates how much work remains.
  *
  * The list view answers "what does this people group have". These charts answer the
  * question one level up: WHERE IS THE GAP, BY LANGUAGE — because a translation is

plugin-designs/gospel-resources/data-tables.vue

@@ -2,11 +2,14 @@
 /**
  * data-tables.vue — the GOSPEL RESOURCES list view.
  *
- * @description Two validated tables: what resources exist per people group, and whether that access is keeping
- *   pace with population growth.
+ * @description Eight tables covering both halves of one question: every gospel resource with its real URL and how much Scripture it is, and the 3,457 people groups where nothing was found with the pools searched recorded per row, plus bridge languages, city bridges, the deaf gap and access against population growth.
  *
- * Two validated tables: what resources exist per people group, and whether that
- * access is keeping pace with population growth.
+ * Eight tables, and the first two answer the two halves of one question. "Every Resource
+ * + Link" lists what EXISTS — 3,550 real, openable resources across 2,686 languages, each
+ * named and scoped as a Full Bible, New Testament or portions. "Where Nothing Was Found"
+ * lists what does NOT — 3,457 people groups, 347 million people — with each row carrying
+ * the pools that were searched and the pools that were not, so an exported CSV can never
+ * be read as a claim about the world.
  *
  * The growth table is the one with teeth: `growing_without_resource` marks a group
  * whose population is RISING while its language still has no scripture and no film

plugin-designs/gospel-resources/resources-list.vue

@@ -2,8 +2,7 @@
 /**
  * resources-list.vue — GOSPEL RESOURCES, by language.
  *
- * @description Which DX people groups have scripture in their own language, and which have none. The zero-resource
- *   languages lead the list, because they are the point of the app.
+ * @description Which people groups have Scripture in their own language and which have none, zero-resource languages first, with every link the verification pass proved and Open Bible Stories labelled as stories rather than as Scripture.
  *
  * Which DX people groups have scripture in their own language — and which have
  * NONE. The zero-resource languages lead, because they are the point of the app.

plugin-designs/gospel-resources/resources-map.vue

@@ -2,11 +2,17 @@
 /**
  * resources-map.vue — THE GOSPEL RESOURCES GLOBAL MAP.
  *
- * @description Every country shaded by how much of its unengaged population has NO gospel resource in their own
- *   language; tap a country for the detail behind the shading.
+ * @description 12,379 people-group pins over a country choropleth: tap a pin for the Scripture, film and Bible-story links that exist in that group's own language with real URLs, tap a country for every group in it, search by group, language or ISO 639-3 code, and filter to the 3,457 groups where nothing was found.
  *
- * Every country shaded by how much of its unengaged population has NO gospel
- * resource in their own language. Tap a country for its detail.
+ * 12,379 people-group pins over a country choropleth, coloured by what each group has
+ * in its OWN language: Scripture and film, something, or nothing found. Tap a pin for
+ * the real links; tap a country for every group in it. Search reaches a named group,
+ * the key doubles as a filter so the gap can be looked at on its own, and a shared URL
+ * reopens the group you were looking at.
+ *
+ * The country shading is an AVERAGE across a country's groups and the dots are
+ * individual groups, which is why a red dot can sit on a green country — that case is
+ * the point of the map, not a rendering fault.
  *
  * > design note 2026-08-01: "mapping out the gospel resources is super important for me
  * > … key city posters, cities with internet, gospel resources — all these are

public/doxa-maps/manifest.json

@@ -564,7 +564,7 @@
         {
           "profile": "charts",
           "file": "charts.vue",
-          "description": "The gap by LANGUAGE (ISO 639-3) rather than by people group — because one translation serves every",
+          "description": "The gap measured by LANGUAGE (ISO 639-3) rather than by people group, because one translation serves every group that speaks it, so counting by group overstates how much work remains.",
           "element": "gospel-resources-map",
           "type": "single",
           "isMap": false,
@@ -578,7 +578,7 @@
         {
           "profile": "data-tables",
           "file": "data-tables.vue",
-          "description": "Two validated tables: what resources exist per people group, and whether that access is keeping",
+          "description": "Eight tables covering both halves of one question: every gospel resource with its real URL and how much Scripture it is, and the 3,457 people groups where nothing was found with the pools searched recorded per row, plus bridge languages, city bridges, the deaf gap and access against population growth.",
           "element": "gospel-resources-map",
           "type": "single",
           "isMap": false,
@@ -592,7 +592,7 @@
         {
           "profile": "resources-list",
           "file": "resources-list.vue",
-          "description": "Which DX people groups have scripture in their own language, and which have none. The zero-resource",
+          "description": "Which people groups have Scripture in their own language and which have none, zero-resource languages first, with every link the verification pass proved and Open Bible Stories labelled as stories rather than as Scripture.",
           "element": "gospel-resources-map",
           "type": "single",
           "isMap": false,
@@ -606,7 +606,7 @@
         {
           "profile": "resources-map",
           "file": "resources-map.vue",
-          "description": "Every country shaded by how much of its unengaged population has NO gospel resource in their own",
+          "description": "12,379 people-group pins over a country choropleth: tap a pin for the Scripture, film and Bible-story links that exist in that group's own language with real URLs, tap a country for every group in it, search by group, language or ISO 639-3 code, and filter to the 3,457 groups where nothing was found.",
           "element": "gospel-resources-map",
           "type": "single",
           "isMap": true,