From 071c928c8a6515310d5841b2bef5fe910b1ff34e Mon Sep 17 00:00:00 2001
From: Venia Silente <veniasilente@protonmail.com>
Date: Fri, 30 Jun 2023 23:48:04 -0400
Subject: [PATCH] Data sources crediting

---
 README.md           |  9 +++++++--
 original/SOURCES.md | 21 +++++++++++++++++++++
 2 files changed, 28 insertions(+), 2 deletions(-)
 create mode 100644 original/SOURCES.md

diff --git a/README.md b/README.md
index 06b8aae..de98bd4 100644
--- a/README.md
+++ b/README.md
@@ -21,7 +21,12 @@ Dictionary files follow a naming schema of the form ``{content}.{lang}.dic``, wh
 
 * Dictionaries for Spanish ("es") and Italian ("it") official Pokémon names are **currently pending**, as it was not until G9's release of Paradox forms that the "it" and "es" internationalization teams started diverging from the "en" namelist.
 
-* Files with the prefix ``pkunreleased`` contain names for unreleased entities, such as the leaked "beta Pokémon". These are credited in an associated CSV file where possible.
-
+* Files with the prefix ``pkunreleased`` contain names for unreleased entities, such as the leaked "beta Pokémon". 
+
+* Where possible, data sources are credited in a folder-level ``SOURCES.md`` or in a per-source associated CSV file.
+
+## License
+
+These contents are licensed under **Creative Commons** NC-SA-4.0. For more details check ``LICENSE``.
 
 
diff --git a/original/SOURCES.md b/original/SOURCES.md
new file mode 100644
index 0000000..3388762
--- /dev/null
+++ b/original/SOURCES.md
@@ -0,0 +1,21 @@
+## Data Sources
+
+For original / canon information, the following sources are used:
+
+* Files ``pokedex_pokemon.${lang}.dic`` are fed from Bulbapedia's page of "List of Pokémon in other languages" and from a veekun schema-compatible database listing.
+* Files ``moves.${lang}.dic`` are fed from Bulbapedia's page of "List of moves in other languages" and from a veekun schema-compatible database listing.
+* Other files are fed from Bulbapedia's tabular data pages on internationalization, such as ["List of locations in other languages"](https://bulbapedia.bulbagarden.net/wiki/List_of_locations_in_other_languages)
+
+The following SQL query, applied to a Veekun "pokedex" schema, extracts in its second column the names for Pokémon in a given ISO language code ("``{lang}``"):
+
+```
+select P.id, PN.name
+FROM
+pokemon P 
+left join pokemon_species_names PN 
+on PN.pokemon_species_id = P.id  
+join languages L on PN.local_language_id=L.id
+and L.identifier={lang}
+where P.id is not null 
+order by P.id, L.id
+```