SODA for SPARC Documentation

A comprehensive documentation of the SODA for SPARC project!

What is SODA for SPARC? · Documentation · Changelog · Report Bug · Request Feature

:notebook_with_decorative_cover: Table of Contents

• About the Documentation
  • Tech Stack
  • Color Reference
  • Environment Variables
• Getting Started
  • Prerequisites
  • Run Locally
  • Versioning
  • Build locally
  • Deployment
• Contributing
  • Code of Conduct
• FAQ
• License
• Contact
• Acknowledgements

:star2: About the Documentation

:space_invader: Tech Stack

:art: Color Reference

Color	Hex
Primary Color	#13716D
Secondary Color	#BA0D49
Accent Color	#6B7280
Text Color	#1C1E21

:key: Environment Variables

To run this project, you will need to add the following environment variables to your .env.local file

• None at the moment

:toolbox: Getting Started

:bangbang: Prerequisites

This project uses Yarn as package manager

npm install --global yarn

Additionally, a version of Node.js that is >= 14 is required for compatibility with Docusarus. If your Node.js version is < 14 you can download the latest Node.js version from the Node.js download page.

:running: Run Locally

Clone the project

git clone https://github.com/fairdataihub/SODA-for-SPARC-Docs.git

Go to the project directory

cd SODA-for-SPARC-Docs

Install dependencies

yarn install

Start the server

yarn start

:stopwatch: Versioning

You can use the version script to create a new documentation version based on the latest content in the docs directory. That specific set of documentation will then be preserved and accessible even as the documentation in the docs directory changes moving forward.

Ideally, you should create a new branch and update the relevant pages. Then send a PR with @megasanjay or @aaronm-2112 on the review page.

Only do these steps after all changes to the documentation for the specific version have been completed:

1. Update the docs changelog to be on parity with the changelog in @SODA-for-SPARC
2. Make sure the current docs version (the docs directory) is ready to be frozen.
3. Update the version key in package.json for this repository.

yarn run docusaurus docs:version 5.3.0

This will freeze the current version of the documentation. The files under the current docs directory will be considered to be Upcoming 🚧 version.

:building_construction: Build locally

Use this step to build a local production version of the site. Use serve to preview the local build.

yarn build
yarn serve

:triangular_flag_on_post: Deployment

You will not need to do anything to the hosted site. Continuous Delivery has been setup with Vercel. All you need to do is push your commit and wait for it to deploy.

:wave: Contributing

Contributions are always welcome!

See contributing.md for ways to get started.

:scroll: Code of Conduct

Please read the Code of Conduct

:grey_question: FAQ

• Can I make changes to previous versions of the documentation?

  • Yes, you can make changes to previous versions of the documentation. You can do this by creating a new branch and adding your changes directly in the versioned_docs directory.

:warning: License

Distributed under the MIT License. See LICENSE for more information.

:handshake: Contact

Contact us on Twitter: @fairdataihub

Send us an E-mail: info@fairdataihub.org

Project Link: SODA-for-SPARC

:gem: Acknowledgements

A special thank you to Vercel for hosting our application documentation.