From 0ec97920aed6b2d5f1cc94360469a8d3192abcc1 Mon Sep 17 00:00:00 2001 From: Munyoki Kilyungi Date: Wed, 11 Oct 2023 13:43:29 +0300 Subject: Fix spelling and structural issues in doc. --- issues/rdf/0001-rdf-ui-frontend.gmi | 84 +++++++++++++++++++++++++++++++++++++ issues/rdf/0001-rdf-ui-frontent.gmi | 82 ------------------------------------ 2 files changed, 84 insertions(+), 82 deletions(-) create mode 100644 issues/rdf/0001-rdf-ui-frontend.gmi delete mode 100644 issues/rdf/0001-rdf-ui-frontent.gmi (limited to 'issues/rdf') diff --git a/issues/rdf/0001-rdf-ui-frontend.gmi b/issues/rdf/0001-rdf-ui-frontend.gmi new file mode 100644 index 0000000..5e586fa --- /dev/null +++ b/issues/rdf/0001-rdf-ui-frontend.gmi @@ -0,0 +1,84 @@ +# UI Frontend for RDF + +## Tags + +* assigned: bonfacem +* type: issue + +### Motivation + +We have GN Metadata in RDF already. Right now, it's only accessible through a SPARQL endpoint, and it's not benefiting anyone. We want to create REST endpoints to let both users and machines easily acess the data. We'll also demonstrate how HTMX reduces the need for heavy javascript in a way that can be adopted in other parts of the GN website. + +### Context + +We've finished modeling GeneNetwork Metadata in RDF. It's sitting in a public SPARQL endpoint, but no one can use it. To alleviate this, we're building REST endpoints, which helps our technical strategy and ties into our goal of making data more accessible. We're also using HTMX to make the system more efficient and user-friendly. + + +### Goals + +* Implement REST endpoints for querying/searching metadata about Publications, Datasets, Phenotypes, Generif and Genotype. + +Metric: UPTIME as per indicated by SheepDog; A low Request Per Minute (RPM) of not more than 60s(for large queries). + +* Create UI pages that utilize HTMX to access and display the metadata endpoints effectively. + +Metric: A decent accessibily and web performance score that should be better than the rest of GN. + +* Implement Test Cases for the proposed endpoints to ensure system stability + +Metric: 100% Test Coverage for the new pages. + +* Create UI pages that utilize HTMX to access and display the metadata endpoints effectively. + +Metric: A decent accessibily and web performance score that should be better than the rest of GN. + +### Non-Goals + +* Editing/Adding metadata. This will be tackled in another document. +* Orchestrating a running production virtuoso instance to ensure this work is exposed to the end-user. This needs some co-ordination with Zach/Arun to get done. Changes will be visible in CI/CD but no strong guarantees of a roll-out in production. + +### Milestones + +START DATE: October 11, 2020 + +Milestone 1 - New GN3 Endpoints (json-ld) for Publications, Genotype, Datasets, Phenotype, Probesets; Delete old endpoints: October 16, 2023 + +Milestone 2 - UI Endpoints in GN2: October 25, 2023 + +END DATE: E2E test-cases for GN2: October 31, 2023 + +### Design + +Data output should be in json-ld where feasible. + +### GN3 APIs + +Support for search and pagination + +* GET /metadata/datasets/ +* GET /metadata/datasets?search=""&page=1&per_page=20 +* GET /metadata/publications/ +* GET /metadata/publications?search=""&page=1&per_page=20 +* GET /metadata/genotypes/ +* GET /metadata/genotypes?search=""&page=1&per_page=20 +* GET /metadata/phenotypes/ +* GET /metadata/phenotypes?search=""&page=1&per_page=20 +* GET /metadata/probesets/ +* GET /metadata/probesets?search=""&page=1&per_page=20 +* GET /metadata/genewikis/ + +### UI Pages + +Whenever a resource is unavailable, show a search bar. + +* /datasets/ +* /datasets?search=""&page=1&per_page=20 +* /publications/ +* /publications?search=""&page=1&per_page=20 +* /genotypes/ +* /genotypes?search=""&page=1&per_page=20 +* /phenotypes/ +* /phenotypes?search=""&page=1&per_page=20 +* /probesets/ +* /probesets?search=""&page=1&per_page=20 +* /genewikis/ diff --git a/issues/rdf/0001-rdf-ui-frontent.gmi b/issues/rdf/0001-rdf-ui-frontent.gmi deleted file mode 100644 index 5165120..0000000 --- a/issues/rdf/0001-rdf-ui-frontent.gmi +++ /dev/null @@ -1,82 +0,0 @@ -# UI Frontend for RDF - -## Tags - -* assigned: bonfacem -* type: issue - -### Motivation - -We have GN Metadata in RDF already. Right now, it's only accessible through a SPARQL endpoint, and it's not benefiting anyone. We want to create REST endpoints to let both users and machines easily acess the data. We'll also demonstrate how HTMX reduces the need for heavy javascript in a way that can be adopted in other parts of the GN website. - -### Context - -We've finished modeling GeneNetwork Metadata in RDF. It's sitting in a public SPARQL endpoint, but no one can use it. To alleviate this, we're building REST endpoints, which helps our technical strategy and ties into our goal of making data more accessible. We're also using HTMX to make the system more efficient and user-friendly. - -### Goals and Non-Goals - -#### Goals - -* Implement REST endpoints for querying/searching metadata about Publications, Datasets, Phenotypes, Generif and Genotype. - -Metric: UPTIME as per indicated by SheepDog; A low Request Per Minute (RPM) of not more than 60s(for large queries). - -* Create UI pages that utilize HTMX to access and display the metadata endpoints effectively. - -Metric: A decent accessibily and web performance score that should be better than the rest of GN. - -* Implement Test Cases for the proposed endpoints to ensure system stability - -Metric: 100% Test Coverage for the new pages. - -* Create UI pages that utilize HTMX to access and display the metadata endpoints effectively. - -Metric: A decent accessibily and web performance score that should be better than the rest of GN. - -#### Non-Goals - -* Editing/Adding metadata. This will be tackled in another document. -* Orchestrating a running production virtuoso instance to ensure this work is exposed to the end-user. This needs some co-ordination with Zach/Arun to get done. Changes will be visible in CI/CD but no strong guarantees of a roll-out in production. - -### Milestones - -START DATE: October 11, 2020 -Milestone 1 - New GN3 Endpoints (json-ld) for Publications, Genotype, Datasets, Phenotype, Probesets; Delete old endpoints: October 16, 2023 -Milestone 2 - UI Endpoints in GN2: October 25, 2023 -END DATE: E2E test-cases for GN2: October 31, 2023 - -### Design - -Data output should be in json-ld where feasible. - -### GN3 APIs - -Support for search and pagination - -* GET /metadata/datasets/ -* GET /metadata/datasets?search=""&page=1&per_page=20 -* GET /metadata/publications/ -* GET /metadata/publications?search=""&page=1&per_page=20 -* GET /metadata/genotypes/ -* GET /metadata/genotypes?search=""&page=1&per_page=20 -* GET /metadata/phenotypes/ -* GET /metadata/phenotypes?search=""&page=1&per_page=20 -* GET /metadata/probesets/ -* GET /metadata/probesets?search=""&page=1&per_page=20 -* GET /metadata/genewikis/ - -### UI Pages - -Whenever a resource is unavailable, show a search bar. - -* /datasets/ -* /datasets?search=""&page=1&per_page=20 -* /publications/ -* /publications?search=""&page=1&per_page=20 -* /genotypes/ -* /genotypes?search=""&page=1&per_page=20 -* /phenotypes/ -* /phenotypes?search=""&page=1&per_page=20 -* /probesets/ -* /probesets?search=""&page=1&per_page=20 -* /genewikis/ -- cgit v1.2.3