Drasi documentation

This repo contains the documentation source for https://drasi.io.

Contributing

Drasi's documentation follows the Diataxis framework for its structure and content. Follow the guidance in here to learn how to get started with contributing and creating new documents for Drasi. Please review our Contributions guide.

Pre-requisites

Node.js

Framework

The documentation website is generated with the Hugo framework.

Theme

The Docsy theme is used to style the generated site. Refer to the Docsy authoring guide for helpful tips on creating content for Drasi.

Install Hugo
Clone the drasi-project/docs repo
Change to the docs subfolder

cd docs/docs
From the root of the drasi-project/docs repo, where this readme is located, run git submodule update --init --recursive --remote to pull Docsy code that is configured as a submodule.
Switch to the Docsy theme folder

docs/themes/docsy folder
Run the command npm install

Run local server

Follow these steps to build the docs locally

Open a terminal window
Ensure that you are in the docs/docs folder of the repo
Run the command hugo server

The documentation website will be accessible on the URL http://localhost:1313/

Deploying to Azure

The documentation website is hosted on Azure in an App Service called project-drasi-docs in the project-drasi-docs Resource Group in the Azure Incubations Dev subscription.

Currently, we need to manually build and deploy the documentation site. The easiest way to do this is:

Open a terminal
Change to the docs folder
Run the command hugo to build the site
Use the Azure App Service Extension for VS Code to publish the docs/docs/public folder to the project-drasi-docs App Service.

Once deployed, the documentation site is accessible at the URL https://project-drasi-docs.azurewebsites.net/.

Access to the site is restricted to people that are members of the Project Drasi Preview Users AD Group.

Code of Conduct

Please refer to Drasi's Community Code of Conduct.

drasi-project/docs