From f00a235942539d69e815c26d183fe601ca9ce9a1 Mon Sep 17 00:00:00 2001 From: Kaviraj Date: Mon, 28 Jun 2021 10:35:18 +0200 Subject: [PATCH] Update steps to release versioned docs (#3897) * Update steps to release versioned docs. This makes versioned docs in consistent with Grafana. More details: https://github.com/grafana/website/pull/4970 https://github.com/grafana/website/pull/4970 Signed-off-by: Kaviraj * Add step to update `latest_version` Signed-off-by: Kaviraj --- docs/sources/maintaining/release.md | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/docs/sources/maintaining/release.md b/docs/sources/maintaining/release.md index 226b039ee662..9fcd437d858f 100644 --- a/docs/sources/maintaining/release.md +++ b/docs/sources/maintaining/release.md @@ -104,9 +104,16 @@ Once the previous two steps are completed, you can publish your draft! Loki docs are versioned. Follow the below steps to version Loki docs for this release. +>NOTE: Here $LOCAL_LOKI_PATH is your local path where Loki is checked out with correct $VERSION + 1. Clone Grafana website [repo](https://github.com/grafana/website) -1. Create new branch `git checkout -b loki-v1.2.3` (replace `v1.2.3` with current release version) -1. Run `make project-doc-release` -1. It prompts for two things. `Project name` and `version`. Project name is `loki` and version is current release version. +1. Create new branch `git checkout -b $VERSION` (replace `$VERSION` with current release version. e.g: `v2.2.1`) +1. Run `mv content/docs/loki/next content/docs/loki/next.main` +1. Run `mkdir content/docs/loki/next` +1. Run `cp -R $LOCAL_LOKI_PATH/docs/sources/* content/docs/loki/next` +1. Run `scripts/docs-release.sh loki latest next` +1. Run `scripts/docs-release.sh loki $VERSION latest` +1. Run `mv content/docs/loki/next.main content/docs/loki/next` +1. Update `version_latest` to `$VERSION` in `content/docs/loki/_index.md` 1. Docs will be generated for this release. 1. Create PR and Merge it after approval.