summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMunyoki Kilyungi2024-09-10 08:44:23 +0300
committerMunyoki Kilyungi2024-09-10 08:45:16 +0300
commitb3228bf854f3ac4cd6b9c25f0219fecb8cbc8b35 (patch)
tree7ae6ac37c80c8c611efb4ab83fa408b94a19ef0c
parent5257b9ba42e79be5f0418e3b8fc348647c4f4061 (diff)
downloadgn-gemtext-b3228bf854f3ac4cd6b9c25f0219fecb8cbc8b35.tar.gz
Create new ADR on adding RDF tests in GN3.
Signed-off-by: Munyoki Kilyungi <me@bonfacemunyoki.com>
-rw-r--r--topics/ADR/gn3/000-add-test-cases-for-rdf.gmi21
1 files changed, 21 insertions, 0 deletions
diff --git a/topics/ADR/gn3/000-add-test-cases-for-rdf.gmi b/topics/ADR/gn3/000-add-test-cases-for-rdf.gmi
new file mode 100644
index 0000000..deb9fa3
--- /dev/null
+++ b/topics/ADR/gn3/000-add-test-cases-for-rdf.gmi
@@ -0,0 +1,21 @@
+# [ADR-000/gn3] Add RDF Test Cases
+
+* author: bonfacem
+* status: proposed
+* reviewed-by: jnduli
+
+## Context
+
+We have no way of ensuring the integrity of our SPARQL queries in GN3. As such, GN3 is fragile to breaking changes when the TTL files are updated.
+
+## Decision
+
+In Virtuoso, we load all our data to a default named graph: <http://genenetwork.org>. For SPARQL/RDF tests, we should upload test ttl files to a test named graph: <http://test.genenetwork.org>, and run our end-to-end API tests against that named graph.
+
+## Consequences
+
+* Extra bootstrapping to load ttl files when running the test.
+* Extra documentation to GN developers on how to run virtuoso locally to get the tests running.
+* Testing against gn-machines to make sure that all things run accordingly.
+* Extra maintenance costs to keep the TTL files in lockstep with the latest RDF changes during re-modeling.
+* Improvement in GN3 reliability.