AI-READI Documentation

Documentation for the AI-READI project.

docs.aireadi.org

:star2: About

content here

:toolbox: Getting Started

:bangbang: Prerequisites

This project uses Yarn as package manager

bash 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.

: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

:running: Run Locally

Clone the project

bash git clone https://github.com/AI-READI/ai-readi-docs.git

Go to the project directory

bash cd ai-readi-docs

Install dependencies

bash yarn install

Start the server

bash yarn dev

: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 @bvhpatel on the review page.

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

1. Make sure the current docs version (the docs directory) is ready to be frozen.
2. Update the version key in package.json for this repository.

bash yarn run docusaurus docs:version 2

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.

bash yarn build yarn serve

:triangularflagon_post: Deployment

You will not need to do anything to the hosted site. Continuous Delivery has been setup with Azure Static Web Apps. 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

:gem: Acknowledgements

This project is funded by the NIH under award number 1OT2OD032644. The content is solely the responsibility of the authors and does not necessarily represent the official views of the NIH.