Merge pull request #55 from kabilar/main

Refactor layout

Author: dimitri-yatsenko

mkdocs.yaml

@@ -7,7 +7,7 @@ repo_url: https://github.com/datajoint-company/datajoint-docs
 nav:
   - Welcome: index.md
   - DataJoint Python: core/datajoint-python/
-  - Elements:
+  - DataJoint Elements:
     - elements/index.md
     - Concepts: elements/concepts.md
     - User Guide: elements/user-guide.md
@@ -21,22 +21,24 @@ nav:
       - Dissemination: elements/management/dissemination.md
       - Adoption: elements/management/adoption.md
   - Additional Resources: additional-resources.md
-  - Projects: projects.md
-  - Publications: publications.md
-  - Citation: citation.md
-  - Community:
-    - Support: community/support.md
-    - Events: community/events.md
-    - Contribute: community/contribute.md
-    - Licenses: community/licenses.md
-    - Team: community/team.md
-    - History: community/history.md
-    - Partnership - DANDI: community/partnership-dandi.md
-    - Partnership - Facemap: community/partnership-facemap.md
-    - Partnership - INCF: community/partnership-incf.md
-    - Partnership - NWB: community/partnership-nwb.md
-    - Partnership - Open Ephys GUI: community/partnership-openephysgui.md
-    - Partnership - Suite2p: community/partnership-suite2p.md
+  - Project Showcase:
+    - projects/index.md
+    - Catalog: https://catalog.datajoint.io
+    - Teams: projects/teams.md
+    - Publications: projects/publications.md
+  - Support & Events: support-events.md
+  - Partnerships:
+    - DANDI: partnerships/dandi.md
+    - Facemap: partnerships/facemap.md
+    - INCF: partnerships/incf.md
+    - NWB: partnerships/nwb.md
+    - Open Ephys GUI: partnerships/openephysgui.md
+    - Suite2p: partnerships/suite2p.md
+  - About:
+    - History: about/history.md
+    - Team: about/datajoint-team.md
+    - Citation Guidelines: about/citation.md
+    - Contribution Guidelines: about/contribute.md
 
 # ---------------------------- STANDARD -----------------------------
 

src/about/citation.md

@@ -0,0 +1,27 @@
+# Citation Guidelines
+
+If your work uses the DataJoint Python, MATLAB, or Elements, please cite the
+respective manuscripts and Research Resource Identifiers (RRIDs).
+
+## DataJoint Python and MATLAB
+
+- Yatsenko D, Reimer J, Ecker AS, Walker EY, Sinz F, Berens P, Hoenselaar A, Cotton
+  RJ, Siapas AS, Tolias AS. DataJoint: managing big scientific data using MATLAB or
+  Python. bioRxiv. 2015 Jan 1:031658. doi: https://doi.org/10.1101/031658
+
+- [RRID:SCR_014543](https://scicrunch.org/resolver/SCR_014543)
+
+## DataJoint Relational Model
+
+- Yatsenko D, Walker EY, Tolias AS. DataJoint: a simpler relational data model.
+  arXiv:1807.11104. 2018 Jul 29. doi: https://doi.org/10.48550/arXiv.1807.11104
+
+- [RRID:SCR_014543](https://scicrunch.org/resolver/SCR_014543)
+
+## DataJoint Elements
+
+- Yatsenko D, Nguyen T, Shen S, Gunalan K, Turner CA, Guzman R, Sasaki M, Sitonic D,
+  Reimer J, Walker EY, Tolias AS. DataJoint Elements: Data Workflows for
+  Neurophysiology. bioRxiv. 2021 Jan 1. doi: https://doi.org/10.1101/2021.03.30.437358
+
+- [RRID:SCR_021894](https://scicrunch.org/resolver/SCR_021894)

src/community/contribute.md src/about/contribute.mdsrc/community/contribute.md renamed to src/about/contribute.md

@@ -44,5 +44,5 @@ The first-person pronouns "we" and "our" in these documents refer to those liste
 
 The principal components of the Resource are developed and distributed as open-source
 projects and external contributions are welcome. We have adopted a 
-[Contribution Guide](.contribute) for DataJoint, DataJoint Elements,
+[Contribution Guide](contribute.md) for DataJoint, DataJoint Elements,
 and related open-source tools.

src/community/team.md src/about/datajoint-team.mdsrc/community/team.md renamed to src/about/datajoint-team.md

@@ -2,47 +2,52 @@
 
 A collection of additional open-source tools for building and operating scientific data pipelines.
 
-## API
+## APIs
 
 <div class="grid cards" markdown>
 
--   :fontawesome-brands-java:{ .lg .middle } **DataJoint for MATLAB**
+-   :fontawesome-brands-java:{ .lg .middle } **DataJoint MATLAB**
 
     ---
 
     A MATLAB client for defining, operating, and querying data pipelines.
 
-    :octicons-arrow-right-24: [Legacy docs](https://docs.datajoint.org/matlab/) | [Source code](https://github.com/datajoint/datajoint-matlab)
+    :octicons-arrow-right-24: [Legacy docs](https://docs.datajoint.org/matlab/) | 
+    [Source code](https://github.com/datajoint/datajoint-matlab)
 
--   :fontawesome-solid-flask:{ .lg .middle } **Pharus**
+-   :fontawesome-solid-flask:{ .lg .middle } **DataJoint Pharus**
 
     ---
 
     A REST API server for interacting with DataJoint pipelines.
 
-    :octicons-arrow-right-24: [Legacy docs](https://datajoint.github.io/pharus/) | [Source code](https://github.com/datajoint/pharus/)
+    :octicons-arrow-right-24: [Legacy docs](https://datajoint.com/docs/core/pharus) | 
+    [Source code](https://github.com/datajoint/pharus/)
 
 </div>
 
 ## Web Applications
 
 <div class="grid cards" markdown>
 
--   :fontawesome-brands-chrome:{ .lg .middle } **LabBook**
+-   :fontawesome-brands-chrome:{ .lg .middle } **DataJoint LabBook**
 
     ---
 
     A browser-based graphical user interface for data entry and navigation. 
 
-    :octicons-arrow-right-24: [Legacy docs](https://datajoint.github.io/datajoint-labbook/) | [Source code](https://github.com/datajoint/datajoint-labbook/)
+    :octicons-arrow-right-24: [Legacy 
+    docs](https://datajoint.com/docs/core/datajoint-labbook/) | 
+    [Source code](https://github.com/datajoint/datajoint-labbook/)
 
--   :fontawesome-brands-chrome:{ .lg .middle } **SciViz**
+-   :fontawesome-brands-chrome:{ .lg .middle } **DataJoint SciViz**
 
     ---
 
     A framework for making low-code web apps for data visualization.
 
-    :octicons-arrow-right-24: [Legacy docs](https://datajoint.com/docs/core/sci-viz/) | [Source code](https://github.com/datajoint/sci-viz)
+    :octicons-arrow-right-24: [Legacy docs](https://datajoint.com/docs/core/sci-viz/) | 
+    [Source code](https://github.com/datajoint/sci-viz)
 
 </div>
 
@@ -68,49 +73,79 @@ graph
 ```
 <div class="grid cards" markdown>
 
--   :fontawesome-brands-docker:{ .lg .middle } [**datajoint/mysql**](https://hub.docker.com/r/datajoint/mysql)
+-   :fontawesome-brands-docker:{ .lg .middle } **datajoint/mysql**
 
     ---
-    MySQL server pre-configured to work smoothly with DataJoint.
+    MySQL server configured to work with DataJoint.
 
-    :octicons-arrow-right-24: [Legacy docs](https://github.com/datajoint/mysql-docker#mysql-for-datajoint).
+    :octicons-arrow-right-24: [Docker 
+    image](https://hub.docker.com/r/datajoint/mysql) | 
+    [Source code](https://github.com/datajoint/mysql-docker)
 
--   :fontawesome-brands-docker:{ .lg .middle } [**datajoint/miniconda3**](https://hub.docker.com/r/datajoint/miniconda3)
+-   :fontawesome-brands-docker:{ .lg .middle } **datajoint/miniconda3**
 
     ---
 
-    A minimal Python image with [conda](https://docs.conda.io/en/latest/).
+    Minimal Python Docker image with [conda](https://docs.conda.io/en/latest/).
 
--   :fontawesome-brands-docker:{ .lg .middle } [**datajoint/djbase**](https://hub.docker.com/r/datajoint/djbase)
+    :octicons-arrow-right-24: [Docker
+    image](https://hub.docker.com/r/datajoint/miniconda3) | 
+    [Legacy docs](https://datajoint.github.io/miniconda3-docker/) | 
+    [Source code](https://github.com/datajoint/miniconda3-docker)
+
+-   :fontawesome-brands-docker:{ .lg .middle } **datajoint/djbase**
 
     ---
 
-    A minimal base docker image with DataJoint Python dependencies installed. 
+    Minimal base Docker image with DataJoint Python dependencies installed. 
+
+    :octicons-arrow-right-24: [Docker 
+    image](https://hub.docker.com/r/datajoint/djbase) | 
+    [Legacy docs](https://datajoint.github.io/djbase-docker/) | 
+    [Source code](https://github.com/datajoint/djbase-docker)
 
--   :fontawesome-brands-docker:{ .lg .middle } [**datajoint/djtest**](https://hub.docker.com/r/datajoint/djtest)
+-   :fontawesome-brands-docker:{ .lg .middle } **datajoint/djtest**
 
     ---
 
-    A docker image for running tests related to DataJoint Python. 
+    Docker image for running tests related to DataJoint Python. 
+
+    :octicons-arrow-right-24: [Docker 
+    image](https://hub.docker.com/r/datajoint/djtest) | 
+    [Legacy docs](https://datajoint.github.io/djtest-docker/) | 
+    [Source code](https://github.com/datajoint/djtest-docker)
 
--   :fontawesome-brands-docker:{ .lg .middle } [**datajoint/datajoint**](https://hub.docker.com/r/datajoint/datajoint)
+-   :fontawesome-brands-docker:{ .lg .middle } **datajoint/datajoint**
 
     ---
 
     Official DataJoint Docker image.
 
-    :octicons-arrow-right-24: [Legacy docs](https://docs.datajoint.org/python/).
+    :octicons-arrow-right-24: [Docker
+    image](https://hub.docker.com/r/datajoint/datajoint) | 
+    [Source code](https://github.com/datajoint/datajoint-python)
 
--   :fontawesome-brands-docker:{ .lg .middle } [**datajoint/djlab**](https://hub.docker.com/r/datajoint/djlab)
+-   :fontawesome-brands-docker:{ .lg .middle } **datajoint/djlab**
 
     ---
 
- A docker image optimized for running a JupyterLab environment with DataJoint Python. 
+    Docker image optimized for running a JupyterLab environment with DataJoint Python. 
 
--   :fontawesome-brands-docker:{ .lg .middle } [**datajoint/djlabhub**](https://hub.docker.com/r/datajoint/djlabhub)
+    :octicons-arrow-right-24: [Docker 
+    image](https://hub.docker.com/r/datajoint/djlab) | 
+    [Legacy docs](https://datajoint.github.io/djlab-docker/) | 
+    [Source code](https://github.com/datajoint/djlab-docker)
+
+-   :fontawesome-brands-docker:{ .lg .middle } **datajoint/djlabhub**
 
     ---
 
- A docker image optimized for deploying to JupyterHub a JupyterLab environment with DataJoint Python. 
+    Docker image optimized for deploying to JupyterHub a JupyterLab environment with 
+    DataJoint Python. 
+
+    :octicons-arrow-right-24: [Docker 
+    image](https://hub.docker.com/r/datajoint/djlabhub) | 
+    [Legacy docs](https://datajoint.github.io/djlabhub-docker/) | 
+    [Source code](https://github.com/datajoint/djlabhub-docker)
 
 </div>