Create System Banners Documentation

Document the new system banners enterprise only feature
for organizations to communicate with their staff via
announcement banners

Author: jameshill

data/nav.yml

@@ -314,6 +314,8 @@
           path: "team-management"
         - name: "User and team permissions"
           path: "team-management/permissions"
+        - name: "System banners"
+          path: "team-management/system-banners"
     - name: "Governance"
       children:
         - name: "Overview"

pages/team_management.md

@@ -7,4 +7,5 @@ toc: false
 Team management is fundamental in CI/CD tools to ensure streamlined processes, proper access controls, and efficient collaboration. Buildkite provides features for your team management needs:
 
 - [User and team permissions](/docs/team-management/permissions)
+- [System banners](/docs/team-management/system-banners) (enterprise only)
 - [Managing API access tokens](/docs/apis/managing-api-tokens) (under the APIs section)

pages/team_management/system_banners.md

@@ -0,0 +1,30 @@
+---
+keywords: docs, tutorials, 2fa
+---
+
+# System banners (enterprise only)
+
+Organization owners can create announcement banners for the organization. Banners
+will be displayed to all organization members at the top of every page in the
+organization.
+
+You can use Markdown to format your message and link to other documentation
+which you may have.
+
+## Steps to creating a banner
+
+- You must be logged in as an Administrator
+- Visit the Organization's [settings page]
+- Add a message to the **System banners** panel
+- Click **Save Banner**
+
+[settings page]: <https://buildkite.com/organizations/~/settings>
+
+## Programmatically creating a system banner
+
+You can create a system banner programmatically via the GraphQL API.
+
+Please review the GraphQL [cookbook] on instructions on how to create
+a banner via the API.
+
+[cookbook]: </docs/apis/graphql/cookbooks/organizations#create-a-banner>