Docs

screenshot of Docs

Hugo site using Docsy theme as submodule

Overview:

This document is a product analysis of the Armory documentation site. The site is hosted by Netlify and welcomes contributions from outside users. The site utilizes the Hugo extended version and the Docsy theme as a Go module. It also has built-in support for tools such as Mermaid, PlantUML, and draw.io. The document provides instructions on cloning the project and making changes to the documentation.

Features:

  • Hosted by Netlify
  • Utilizes the Hugo extended version
  • Uses the Docsy theme as a Go module
  • Built-in support for Mermaid, PlantUML, and draw.io

Installation:

To install the Armory documentation site, follow these steps:

  1. Install the extended version of Hugo by running the command brew install hugo.
  2. Ensure that your workstation has the required software installed. Refer to the installation prerequisites on the Docsy website for more information.
  3. Clone the project by creating a fork of the repository.
  4. Set your forked repository as the upstream remote.
  5. Confirm the origin and upstream repositories.
  6. Update your local repository by fetching commits from the origin and upstream repositories.
  7. Create a new working branch based on upstream/master.
  8. Make your desired changes to the content in the content/en/docs directory.

Summary:

The Armory documentation site is a valuable resource for users looking to contribute to the project. It is hosted by Netlify and utilizes the Hugo extended version and the Docsy theme. The site also has built-in support for tools such as Mermaid, PlantUML, and draw.io. The installation process involves cloning the project, setting the upstream remote, updating the local repository, and making changes to the desired file. Overall, the documentation site provides a user-friendly platform for collaboration and updates.