Documentation

The documentation is built with VuePress v2open in new window. The pages are written in Markdown and are located in the docs directory.

Small changes

If you want to make small changes to the documentation, you can do so directly in the GitHub web interface. Just navigate to the file you want to change and click the pencil icon in the top right corner.

There is a link on the bottom of each page to edit the file directly in the GitHub web interface.

Local development

If you want to make larger changes to the documentation, you can clone the repository.

Developing with Visual Studio Code and Docker

  1. Install Visual Studio Codeopen in new window.

  2. Install the Remote - Containersopen in new window extension.

  3. Go to the Node-RED Home Assistantopen in new window repository and fork it.

  4. Clone your forked repository to your local machine.

    git clone https://github.com/<GITHUB_USER_NAME>/node-red-contrib-home-assistant-websocket
    
  5. Open the repository in Visual Studio Code.

  6. Click on the green "Open a Remote Window" button in the bottom left corner and select "Reopen in Container".

  7. Open a terminal in Visual Studio Code and run npm install --save-dev to install the dependencies.

  8. Run npm run docs:dev to start the development server.

Manual environment

  1. Install Node.jsopen in new window.

  2. Go to the Node-RED Home Assistantopen in new window repository and fork it.

  3. Clone your forked repository to your local machine.

    git clone https://github.com/<GITHUB_USER_NAME>/node-red-contrib-home-assistant-websocket
    
  4. Open the repository in your favorite editor.

  5. Run npm install --save-dev to install the dependencies.

  6. Run npm run docs:dev to start the development server.