Developer page with boxes, buttons, icons

Author: PhilReedData

README.md

@@ -2,7 +2,9 @@
 
 Separate the training docs/help content to separate repo, like [IBISBA Handboook](https://ibisba.github.io/workshop/docs/intro.html).
 
-Built using [Jupyter Book 1](https://jupyterbook.org/).
+Built using [Jupyter Book 1](https://jupyterbook.org/). For additional guidance, see:
+
+- [Anatomy of a Jupyter Book (TeachBooks.io)](https://teachbooks.io/manual/basic-features/jupyterbook.html)
 
 To run locally, install Jupyter Book then build:
 ```shell

TeSS_docs/developers/code-data.md

@@ -2,11 +2,64 @@
 
 TeSS is committed to the FAIR principles: making data findable, accessible, interoperable and re-usable. As such, all content in TeSS is available under the CC BY 4.0 licence, and can be accessed through our API and widgets. The TeSS codebase is also available to re-use under the BSD Licence, and can be found on GitHub.
 
+
+::::{grid} 1 1 2 2
+:class-container: text-center
+:gutter: 3
+
+:::{grid-item-card}
+
+{octicon}`mark-github` **Software**
+^^^
+
+The source code for TeSS [is available on GitHub](https://github.com/ElixirTeSS/TeSS), under the [BSD 3-Clause](https://tess.elixir-europe.org/about/developers#api:~:text=available%20under%20the-,BSD%203%2DClause,-license.) license.
+:::
+
+
+:::{grid-item-card}
+
+{fas}`plug` **Data**
+^^^
+
+Data in TeSS can be accessed via our [API](#api), under the [CC-BY 4.0](https://creativecommons.org/licenses/by/4.0/).
+:::
+
+::::
+
+
 ## Widgets
 Widgets are chunks of javascript code that can be copied into website source code to display TeSS content. There are several different styles and functionalities available from our configurable widget suite. Widgets can be used to enhance your site and offer your community lists of relevant events or training resources.
 
+```{button-link} https://elixirtess.github.io/TeSS_widgets/
+:color: primary
+View our available widgets
+```
 
 
 ## API
 
-TeSS has a fully functioning JSON API. You can explore our JSON-API by appending .json_api to the end of the URL of most pages (excluding parameters). For example:
+TeSS has a fully functioning JSON API. You can explore our JSON-API by appending .json_api to the end of the URL of most pages (excluding parameters). For example:
+
+```
+https://tess.elixir-europe.org/events.json_api
+https://tess.elixir-europe.org/materials.json_api?scientific_topics=RNA-Seq
+https://tess.elixir-europe.org/content_providers.json_api
+https://tess.elixir-europe.org/workflows.json_api
+```
+
+The full documentation for the TeSS JSON API can be found here:
+
+```{button-link} hhttps://tess.elixir-europe.org/api/json_api
+:color: primary
+View the JSON-API documentation
+```
+
+
+## Developer guides
+
+There are additional guides for installing and configuring a TeSS instance.
+
+```{button-link} https://github.com/ElixirTeSS/TeSS/tree/master/docs
+:color: primary
+View the developer guides (on GitHub)
+```

TeSS_docs/index.md

@@ -10,9 +10,8 @@ This documentation is intended to provide help and information on how to use a t
 :::{grid-item-card}
 :link: overview/tess
 :link-type: doc
-:class-header: bg-light
 
-Overview
+**Overview**
 ^^^
 
 What is TeSS, definitions of terms.
@@ -21,33 +20,28 @@ What is TeSS, definitions of terms.
 :::{grid-item-card}
 :link: accounts/user
 :link-type: doc
-:class-header: bg-light
 
-Account creation
+**Account creation**
 ^^^
 
 Creating a user account, setting up a content provider.
-
 :::
 
 :::{grid-item-card}
 :link: spaces/intro-spaces
 :link-type: doc
-:class-header: bg-light
 
-Spaces
+**Spaces**
 ^^^
 
 When to set up a TeSS space, how to credit other spaces' materials.
-
 :::
 
 :::{grid-item-card}
 :link: content/auto
 :link-type: doc
-:class-header: bg-light
 
-Content
+**Content**
 ^^^
 
 Automatically or manually register events, materials or learning paths.
@@ -56,9 +50,8 @@ Automatically or manually register events, materials or learning paths.
 :::{grid-item-card}
 :link: developers/code-data
 :link-type: doc
-:class-header: bg-light
 
-Developers
+**Developers**
 ^^^
 
 Configure an API or widget.