feat(docs): document how to hide stages from end-users (#1807)

* feat(docs): document how to hide stages from end-users

* fix(docs): address dorbin@ code review comments

Co-authored-by: Dave Dorbin <[email protected]>

_data/navigation.yml

@@ -501,6 +501,8 @@ guides:
         url: /guides/operator/webhook-custom-trust-store/
       - title: "Orca: Redis to SQL"
         url: /guides/operator/orca-redis-to-sql/
+      - title: Hiding Stages
+        url: /guides/operator/hiding-stages/
   - title: Runbooks
     collapsed: true
     children:

guides/operator/hiding-stages.md

@@ -0,0 +1,16 @@
+---
+layout: single
+title:  "Hiding Stages"
+sidebar:
+  nav: guides
+---
+
+If you're using Spinnaker 1.20 or later, stages that are not provider-specific will be
+available by default. To hide specific stages from end-users, set the
+`hiddenStages` property in Deck's [custom profile](/reference/halyard/custom/#custom-profile-for-deck)
+to a list of the keys of stages you wish to hide. For example, to hide the
+Gremlin and Travis stages, include the following in `settings-local.js`:
+
+```js
+ window.spinnakerSettings.hiddenStages = ['gremlin', 'travis'];
+```

setup/ci/travis.md

@@ -25,7 +25,7 @@ repos you should see.
 
    `hal config ci travis enable`
 
-1. Turn on the Travis stage feature:
+1. If you're using Spinnaker 1.19 or earlier, turn on the Travis stage feature:
 
    `hal config features edit --travis true`
 

setup/ci/wercker.md

@@ -28,7 +28,7 @@ and credentials.
    hal config ci wercker enable
    ```
 
-2. And that the Wercker stage feature flag is turned on:
+2. If you're using Spinnaker 1.19 or earlier, make sure that the Wercker stage feature flag is turned on:
 
    ```bash
    hal config features edit --wercker true