This repository contains content for the Stemcell release notes. We publish the this documentation at https://docs.vmware.com/en/Stemcells-for-VMware-Tanzu/services/release-notes/index.html.
The stemcell release notes now publish all stemcells regardless of whether or not they are on Tanzu Network. Each stemcell release in the release notes indicates whether or not they are can be found on Tanzu Network.
The Linux stemcell release notes topic is an auto-generated file stemcells.html
. A script
in the ci
folder checks for new stemcells and outputs stemcells.html.md.erb
. Every 15 minutes,
"pubtools-docs-helper" pushes a commit if the script finds a new release.
Committing to this repository automatically goes to the production site at docs.pivotal.io.
You cannot edit stemcells.html.md.erb
. If you do, your changes will be overridden.
To append new content to the Stemcell Release Notes topic:
-
On a command line, navigate to the
ci
/additional_info
directory. -
Create a file formatted as follows:
_STEMCELL-VERSION.html.md.erb
For example:
_97-32.html.md.erb
The file must begin with an underscore (
_
) and you must replace all.
with-
in the filename. -
Enter your release notes in Markdown format. Avoid headings.
-
Commit and push your new file.
-
Review Stemcell (Linux) Release Notes on the documentation staging site a few minutes to ensure that your partial appends to the release notes of that stemcell version.
If you experience any issues, contact #pcf-docs in Slack.
These docs have been migrated to https://docs.vmware.com and are now published using the following tools:
- docworks is the main tool for managing docs used by writers.
- docsdash is a deployment UI which manages the promotion from staging to pre-prod to production. The process below describes how to upload our docs to staging, replacing the publication with the same version.
This repo contains the following files:
- Markdown files live in this repo.
- The table of contents is now in this repo in the toc.md file. Each page requires an entry in the TOC.
- Variables also live in this repo in the template_variables.yml.
- Run a build of the "Stemcell Release Notes" project to upload the docs to Docs Dash.
- Review your changes on the staging site https://docs-staging.vmware.com/...
- Wait about 1 minute for processing to complete after uploading.
- Go to https://docsdash.vmware.com/deployment-stage.
Prerequisite Needs additional privileges - reach out to a manager on the docs team #tanzu-docs or ask a writer to do this step for you.
-
Go to Staging publications in docsdash
https://docsdash.vmware.com/deployment-stage -
Select a publication (make sure it's the latest version)
-
Click "Deploy selected to Pre-Prod" and wait for the pop to turn green (refresh if necessary after about 10s)
-
Go to Pre-Prod list
https://docsdash.vmware.com/deployment-pre-prod -
Select a publication
-
Click "Sign off for Release"
-
Wait for your username to show up in the "Signed off by" column
-
Select the publication again
-
Click "Deploy selected to Prod"