replicatedhq / help-center

Replicated help center

Local development

Before you are able to run this locally you need to have NodeJS v8.x, YARN and Hugo installed on your machine. If you already have Hugo installed, make sure you have the latest version.

1. Install project dependencies

   make install

2. Back in the root of the project, run

   make build

3. And then run the project

   make serve

4. In your browser navigate to localhost:1313 to view the project.

Staging vs Prod

Help center can be built for either staging or prod via:

Prod

 make build-prod

 make serve-prod

Staging

 make build-staging

 make serve-staging

Indexing Content

Included in this project is the hugo-algolia package, which crawls the /content folder of the site and indexes all the content. If you want to re-index the site and/or send new docs content to Algolia, you can use the following commands:

Index the site

This command indexes the whole site and puts content into a single array.

make index-site

Index the site and send content to Algolia account

This command indexes the whole site and sends the array to Algolia.

make index-and-send

You can index and send content to our staging indices via:

make index-and-send-staging

Adding the KOTS documentaion alert

Simply put the following shortcode after the front matter and before the main page content (or wherever you want the alert to appear) and replace the URL with the URL to the desired article.

{{< kotsdocs "https://kots.io" >}}

help-center's Issues

Helpcenter "Ship Overview" sidebar links to Troubleshooting and Ship Examples don't work

Nothing happens if you click the bottom two links in the sidebar (troubleshooting or ship examples) while on the Ship Overview page at https://help.replicated.com/docs/ship/getting-started/overview/.

It looks like there are pages in these sections, but the hrefs all point to the current page, and not the expected pages.

Running studio with headless installs guide

Create a doc that shows how to run studio w/ headless installs and testing upgrades that way

https://github.com/replicatedhq/studio/

Follow this doc https://help.replicated.com/docs/kb/developer-resources/automate-install/ for automating installations.

See https://github.com/replicatedhq/studio/#getting-started Use the https://get.replicated.com/studio easy install scripts for installing Replicated with Studio

See https://github.com/replicatedhq/studio/#iterating-on-your-yaml A new release can be created by simply updating $HOME/replicated/current.yaml

See https://help.replicated.com/api/replicatedctl/replicatedctl_app-release/ for updating replicated. You may have to source /etc/replicated.alias to get the replicatedctl command in your path. You should be able to use a combination of “replicatedctl app-release ls --pending -q” and “replicatedctl app-release apply --sequence=<sequence