Merge pull request #15 from nesi/AGDR-484

Modified with Claire feedback: change repo name, add info on landing page, change footer

.github/workflows/README.md

@@ -18,7 +18,7 @@ In theory, all this could be done at deployment, but I wanted to make sure that
 
 A series of QA checks run on the documentation.
 
-The checks can be started manually from the ![workflow page](https://github.com/nesi/agdr-docs-concept/actions/workflows/checks.yml/badge.svg),
+The checks can be started manually from the ![workflow page](https://github.com/nesi/agdr-docs/actions/workflows/checks.yml/badge.svg),
 select the target branch, give the pattern of files to include, and select which checks you want done.
 
 Checks will also be run on any _non main_ branch pushes. All checks will be run, but only on _changed_ files.

.vscode/includes.code-snippets

@@ -1,5 +1,5 @@
 {
-	// Place your agdr-docs-concept workspace snippets here. Each snippet is defined under a snippet name and has a scope, prefix, body and 
+	// Place your agdr-docs workspace snippets here. Each snippet is defined under a snippet name and has a scope, prefix, body and 
 	// description. Add comma separated ids of the languages where the snippet is applicable in the scope field. If scope 
 	// is left empty or omitted, the snippet gets applied to all languages. The prefix is what is 
 	// used to trigger the snippet and the body will be expanded and inserted. Possible variables are: 

README.md

@@ -1,4 +1,4 @@
-# agdr-docs-concept
-Proof of Concept for Mkdocs based AGDR support pages.
+# agdr-docs
+Mkdocs based AGDR support pages.
 
-[AGDR support files example](https://nesi.github.io/agdr-docs-concept/docs/index.md)
+[AGDR support files example](https://nesi.github.io/agdr-docs/docs/index.md)

docs/CONTRIBUTING.md

@@ -2,7 +2,7 @@
 title: Contributing
 ---
 
-**[CLICK TO VIEW THIS PAGE RENDERED IN MKDOCS](https://nesi.github.io/agdr-docs-concept/CONTRIBUTING)**{ .hidden }
+**[CLICK TO VIEW THIS PAGE RENDERED IN MKDOCS](https://nesi.github.io/agdr-docs/CONTRIBUTING)**{ .hidden }
 
 !!! prerequisite "See also"
     - For examples of markdown use, [see FORMAT](FORMAT.md).
@@ -21,7 +21,7 @@ It allows accessing a full featured preconfigured development environment remote
 
 Clicking on the following link will open a VS Code instance ready to be used with the latest version of the documentation files.
 
-[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/nesi/agdr-docs-concept?quickstart=1)
+[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/nesi/agdr-docs?quickstart=1)
 
 ## Local Development Environment
 
@@ -34,8 +34,8 @@ You will need to have Python **3.10** or later installed on your computer.
 Clone this repository and create a Python virtual environment using:
 
 ```sh
-git clone https://github.com/nesi/agdr-docs-concept.git
-cd agdr-docs-concept
+git clone https://github.com/nesi/agdr-docs.git
+cd agdr-docs
 python -m venv .venv
 source .venv/bin/activate
 pip3 install -r requirements.txt
@@ -64,23 +64,23 @@ You can use any IDE you want, but various tools have been configured for use wit
 
 #### Recommended Extensions
 
-When opening the workspace for the first time, you should be prompted to install the <a href="https://github.com/nesi/agdr-docs-concept/blob/main/.vscode/extensions.json">Recommended VS Code Plugins</a>.
+When opening the workspace for the first time, you should be prompted to install the <a href="https://github.com/nesi/agdr-docs/blob/main/.vscode/extensions.json">Recommended VS Code Plugins</a>.
 
 #### Snippets
 
 `ctrl` + `space` can be used to aid by auto-completing.
 
 e.g. starting to type an image include `![my image](` then pressing `ctrl` + `space` will show all the valid paths.
 
-Custom snippets can be added in <a href="https://github.com/nesi/agdr-docs-concept/blob/main/.vscode/includes.code-snippets.json">`../.vscode/includes.code-snippets`</a>
+Custom snippets can be added in <a href="https://github.com/nesi/agdr-docs/blob/main/.vscode/includes.code-snippets.json">`../.vscode/includes.code-snippets`</a>
 
 #### Tasks
 
 Some of the same checks run during the GitHub CI, can also be run in VS Code.
 
 This is shown with word underlining, and in the 'PROBLEMS' tab in the terminal.
 
-Tasks allow continuous checks to be run in the background, these can be defined in <a href="https://github.com/nesi/agdr-docs-concept/blob/main/.vscode/tasks.json">`../.vscode/tasks.json`</a>, also include in <a href="https://github.com/nesi/agdr-docs-concept/blob/main/.vscode/settings.json">`../.vscode/settings.json`</a> in order to trigger on save.
+Tasks allow continuous checks to be run in the background, these can be defined in <a href="https://github.com/nesi/agdr-docs/blob/main/.vscode/tasks.json">`../.vscode/tasks.json`</a>, also include in <a href="https://github.com/nesi/agdr-docs/blob/main/.vscode/settings.json">`../.vscode/settings.json`</a> in order to trigger on save.
 
 ## Making a Merge Request
 
@@ -103,7 +103,7 @@ git push origin <branchname>
 CI checks will run on your branch, you can check them under 'Actions'
 Might be worth having a quick look at these before making a pull request.
 
-Make a pull [request](https://github.com/nesi/agdr-docs-concept/pulls)
+Make a pull [request](https://github.com/nesi/agdr-docs/pulls)
 
 Assign a reviewer if you wish.
 
@@ -123,7 +123,7 @@ Feel free to raise an issue, make a proposal or [add words to the dictionary](#a
 
 Certain files need to be fetched from other repos for up to date info. This will be automated, but for not the proccess is manual.
 
-1. Run the [![Fetch Remote Assets](https://github.com/nesi/agdr-docs-concept/actions/workflows/fetch_includes.yml/badge.svg?branch=main&event=workflow_run)](https://github.com/nesi/agdr-docs-concept/actions/workflows/fetch_includes.yml) workflow in this repo.
+1. Run the [![Fetch Remote Assets](https://github.com/nesi/agdr-docs/actions/workflows/fetch_includes.yml/badge.svg?branch=main&event=workflow_run)](https://github.com/nesi/agdr-docs/actions/workflows/fetch_includes.yml) workflow in this repo.
 2. A branch `new-assets` will be created, which can be merged into main.
 
 ## Adding Words to Dictionary
@@ -132,7 +132,7 @@ If the CI is failing the spellcheck phase, and you believe the identified words
 
 1. Visit the [NeSI Word List](https://github.com/nesi/nesi-wordlist), follow the instructions there on adding words.
 2. Once changes to the word list have been merged, return to this repo and run [update remote assets](#update-remote-assets).
-3. You should see your new words in the [Dictionary](assets/glossary/dictionary.txt) if your words included a definition, they will also be in the <a href="https://github.com/nesi/agdr-docs-concept/blob/main/overrides/Glossary.md">Glossary</a>.
+3. You should see your new words in the [Dictionary](assets/glossary/dictionary.txt) if your words included a definition, they will also be in the <a href="https://github.com/nesi/agdr-docs/blob/main/overrides/Glossary.md">Glossary</a>.
 
 ## Raise an issue
 

docs/FORMAT.md

@@ -2,7 +2,7 @@
 title: Formatting
 ---
 
-**[CLICK TO VIEW THIS PAGE RENDERED IN MKDOCS](https://nesi.github.io/agdr-docs-concept/FORMAT/)**{ .hidden }
+**[CLICK TO VIEW THIS PAGE RENDERED IN MKDOCS](https://nesi.github.io/agdr-docs/FORMAT/)**{ .hidden }
 
 !!! prerequisite "See also"
     - To learn how you can contribute, [see CONTRIBUTING](CONTRIBUTING.md).

docs/MACROS.md

@@ -1,4 +1,4 @@
-**[CLICK TO VIEW THIS PAGE RENDERED IN MKDOCS](https://nesi.github.io/agdr-docs-concept/MACROS/)**{ .hidden }
+**[CLICK TO VIEW THIS PAGE RENDERED IN MKDOCS](https://nesi.github.io/agdr-docs/MACROS/)**{ .hidden }
 
 # Info about macros
 

docs/NEWPAGE.md

@@ -2,7 +2,7 @@
 title: Create a new page
 ---
 
-**[CLICK TO VIEW THIS PAGE RENDERED IN MKDOCS](https://nesi.github.io/agdr-docs-concept/NEWPAGE/)**{ .hidden }
+**[CLICK TO VIEW THIS PAGE RENDERED IN MKDOCS](https://nesi.github.io/agdr-docs/NEWPAGE/)**{ .hidden }
 
 !!! prerequisite "See also"
     - To learn how you can contribute, [see CONTRIBUTING](CONTRIBUTING.md).

docs/index.md

@@ -2,7 +2,14 @@
 layout: default
 ---
 
-# [Aotearoa Genomic Data Repository](https://data.agdr.org.nz/)
+# [Aotearoa Genomic Data Repository](https://data.agdr.org.nz/){:target="_blank"}
+
+The Aotearoa Genomic Data Repository provides secure within-nation storage, management and sharing of non-human genomic data generated from biological and environmental samples originating in Aotearoa New Zealand. This resource has been developed to follow the principles of Māori Data Sovereignty, and to enable kaitiakitanga (guardianship), so that iwi, hapū and whānau (tribes, kinship groups and families) can effectively exercise their responsibilities as guardians over biological entities that are taonga (precious or treasured).  
+While the repository is designed to facilitate the sharing of data — making it findable by researchers and interoperable with data held in other genomic repositories — the decision-making process regarding who can access the data is entirely in the hands of those holding kaitiakitanga over each data set.
+
+More information about the design and operating principles of the Aotearoa Genomic Data Repository can be found in our recent publication: [doi.org/10.1111/1755-0998.13866](https://doi.org/10.1111/1755-0998.13866){:target="_blank"}.
+
+The repository has been jointly developed by Genomics Aotearoa and NeSI, and is an evolving project to which we are still adding functionality, so you will see ongoing improvements as we implement new features.
 
 ## Recent activity
 

mkdocs.yml

@@ -35,12 +35,12 @@ plugins:
       verbose: false
       include_dir: overrides
 repo_name: GitHub
-repo_url: https://github.com/nesi/agdr-docs-concept
+repo_url: https://github.com/nesi/agdr-docs
 edit_uri: edit/main/docs/
 site_description: AGDR
 site_dir: public
 site_name: AGDR
-site_url: https://github.com/nesi/agdr-docs-concept
+site_url: https://github.com/nesi/agdr-docs
 extra_css:
   - assets/stylesheets/footer.css
   - assets/stylesheets/my.css

overrides/partials/footer.html

@@ -1,17 +1,7 @@
 <footer class="md-footer">
     <div id="new-footer">
-        <div id="partners">
-          <div id="logos">
-            <a href="https://nesi.org.nz" class="nesi-footer-logo" target="_blank"><img alt="" src="https://www.nesi.org.nz/sites/default/files/LogoNeSI-footer.png"></a>
-            <a href="http://www.mbie.govt.nz/" target="_blank"><img alt="" src="https://www.nesi.org.nz/sites/default/files/media/LogoMBIE.png"></a>
-            <a href="https://www.auckland.ac.nz/" target="_blank"><img alt="" src="https://www.nesi.org.nz/sites/default/files/media/LogoUoA.png"></a>
-            <a href="https://www.niwa.co.nz/" target="_blank"><img alt="" src="https://www.nesi.org.nz/sites/default/files/media/LogoNIWA.png"></a>
-            <a href="https://www.otago.ac.nz/" target="_blank"><img alt="" src="https://www.nesi.org.nz/sites/default/files/media/LogoUoO.png"></a>
-            <a href="http://www.landcareresearch.co.nz/" target="_blank"><img alt="" src="https://www.nesi.org.nz/sites/default/files/LogoManaakiWhenuaLandcareResearch.png"></a>
-          </div>
-        </div>
         <div id="inner">
-          <span id="links"><a href="https://www.nesi.org.nz/copyright" target="_blank">Copyright © <span id="year">2023</span> · New Zealand eScience Infrastructure</a> | <a href="https://www.nesi.org.nz//disclaimer" target="_blank">Disclaimer</a> | <a href="https://www.nesi.org.nz//privacy" target="_blank">Privacy</a>
+          <span id="links"><a href="https://www.nesi.org.nz/copyright" target="_blank">Copyright © <span id="year">2024</span> · New Zealand eScience Infrastructure</a> | <a href="https://www.nesi.org.nz//disclaimer" target="_blank">Disclaimer</a> | <a href="https://www.nesi.org.nz//privacy" target="_blank">Privacy</a>
           </span>
         </div>
     </div>