README.md

Welcome

Welcome to the CloudBees examples repository. This repository is a place for storing tutorials, examples, and other learning materials to complement mentions in product documentation. Of note:

• It is owned and managed by the docs team.
• This repo contains assets that complement mentions in product documentation. As such, it is not standalone.
• It is pre-populated with top-level product folders. Organize content in sub-folders appropriate to your files or projects.

Managing asset links

• When providing a link in product documentation to a repo asset, consider using the raw link where appropriate. This gives the reader a cut/paste-ready version of the asset.

• Choose prudent filenames to minimize future renames. Simply moving a file to a new name breaks exiting links out in the wild. It is recommended to leverage symbolic links to effect "redirects". The following shows how to rename origfile.yaml and then create a hard link to this original name. As a result, links to the old name will automatically "redirect" to the new name.

  // move old file to new name
  git mv origfile.yaml newfile.yaml
  git commit -m "commit message"
  git push
  
  // create link to old file
  ln  newfile.yaml origfile.yaml
  
  // add, commit, and push the symlink
  git add origfile.yaml
  git commit -m "created symlink to the original file"
  git push

In this repo

The following table is a brief summary of each of the example projects.

Directory	Description
cloudbees-build-test-automation	Example files referenced by CloudBees Build and Test Automation documentation.
cloudbees-cd	Example files referenced by CloudBees CD documentation.
cloudbees-ci	Example files referenced by CloudBees CI documentation.
cloudbees-feature-flags	Example files referenced by CloudBees Feature Flags documentation.
cloudbees-sdm	Example files for CloudBees SDM.
pipeline-template-examples	This repository includes a sample Pipeline Template Catalog. The demos folder includes examples of how to customize a template.yaml file.
helm-custom-value-file-examples	Custom Property Value Files for the CloudBees Core for Modern Platforms Helm installation.
flow-on-kubernetes	Sample property value files for CloudBees Flow on Kubernetes Helm installation.