Merge pull request #16143 from github/hidden-docs-alt

Early-access docs V2

Author: sarahs

.env.example

@@ -1,6 +1,3 @@
 ALGOLIA_API_KEY=
 ALGOLIA_APPLICATION_ID=
 ALLOW_TRANSLATION_COMMITS=
-EARLY_ACCESS_HOSTNAME=
-EARLY_ACCESS_SHARED_SECRET=
-GITHUB_TOKEN=

.github/workflows/test.yml

@@ -27,7 +27,7 @@ jobs:
         with:
           cancel_others: 'false'
           github_token: ${{ github.token }}
-          paths: '[".github/workflows/test.yml",".node-version", ".npmrc", "app.json", "content/**", "data/**","lib/**", "Dockerfile", "feature-flags.json", "Gemfile", "Gemfile.lock", "middleware/**", "node_modules/**","package.json", "package-lock.json", "server.js", "tests/**", "translations/**", "Procfile", "webpack.config.js"]'
+          paths: '[".github/workflows/test.yml", ".node-version", ".npmrc", "app.json", "content/**", "data/**","lib/**", "Dockerfile", "feature-flags.json", "Gemfile", "Gemfile.lock", "middleware/**", "node_modules/**","package.json", "package-lock.json", "server.js", "tests/**", "translations/**", "Procfile", "webpack.config.js"]'
 
   test:
     needs: see_if_should_skip
@@ -44,6 +44,9 @@ jobs:
       - if: ${{ needs.see_if_should_skip.outputs.should_skip != 'true' }}
         name: Check out repo
         uses: actions/checkout@5a4ac9002d0be2fb38bd78e4b4dbde5606d7042f
+        with:
+          # Enables cloning the Early Access repo later with the relevant PAT
+          persist-credentials: 'false'
 
       - if: ${{ needs.see_if_should_skip.outputs.should_skip != 'true' }}
         name: Setup node
@@ -70,19 +73,19 @@ jobs:
         name: Install dependencies
         run: npm ci
 
-      - if: ${{ needs.see_if_should_skip.outputs.should_skip != 'true' }}
-        name: Run build script
+      - name: Clone early access
+        if: ${{ needs.see_if_should_skip.outputs.should_skip != 'true' && github.repository == 'github/docs-internal' }}
+        run: npm run heroku-postbuild
+        env:
+          DOCUBOT_REPO_PAT: ${{ secrets.DOCUBOT_REPO_PAT }}
+          GIT_BRANCH: ${{ github.ref }}
+
+      - name: Run build script
+        if: ${{ needs.see_if_should_skip.outputs.should_skip != 'true' && github.repository != 'github/docs-internal' }}
         run: npm run build
 
       - if: ${{ needs.see_if_should_skip.outputs.should_skip != 'true' }}
         name: Run tests
         run: npx jest tests/${{ matrix.test-group }}/
         env:
           NODE_OPTIONS: '--max_old_space_size=4096'
-
-      - name: Send Slack notification if workflow fails
-        uses: rtCamp/action-slack-notify@e17352feaf9aee300bf0ebc1dfbf467d80438815
-        if: failure() && github.ref == 'early-access'
-        env:
-          SLACK_WEBHOOK: ${{ secrets.DOCS_ALERTS_SLACK_WEBHOOK }}
-          SLACK_MESSAGE: 'Tests are failing on the `early-access` branch.'

.gitignore

@@ -1,9 +1,17 @@
 .algolia-cache
 .DS_Store
 .env
-node_modules
+/node_modules/
 npm-debug.log
-coverage
+coverage/
 .linkinator
-broken_links.md
+/assets/images/early-access
+/content/early-access
+/data/early-access
 dist
+
+# blc: broken link checker
+blc_output.log
+blc_output_internal.log
+/dist/
+broken_links.md

content/rest/overview/api-previews.md

@@ -2,7 +2,6 @@
 title: API previews
 intro: You can use API previews to try out new features and provide feedback before these features become official.
 redirect_from:
-  - /early-access/
   - /v3/previews
 versions:
   free-pro-team: '*'
@@ -60,7 +59,7 @@ Create, list, update, and delete environments for pre-receive hooks.
 {% if enterpriseServerVersions contains currentVersion and currentVersion ver_lt "enterprise-server@2.22" %}
 ### Integrations
 
-Manage [integrations](/early-access/integrations/) through the API.
+Manage [integrations](/v3/integrations) through the API.
 
 **Custom media type:** `machine-man-preview`
 **Announced:** [2016-09-14](https://developer.github.com/changes/2016-09-14-Integrations-Early-Access/)

crowdin.yml

@@ -3,17 +3,19 @@ files:
     translation: /translations/%locale%/%original_path%/%original_file_name%
     ignore:
       - '/content/README.md'
+      - '/content/early-access'
   - source: /data/**/*.yml
     translation: /translations/%locale%/%original_path%/%original_file_name%
   - source: /data/**/*.md
     translation: /translations/%locale%/%original_path%/%original_file_name%
     ignore:
-      - 'data/README.md'
-      - 'data/reusables/README.md'
-      - 'data/variables/product.yml'
-      - 'data/variables/README.md'
-      - 'data/graphql'
-      - 'data/products.yml'
+      - '/data/README.md'
+      - '/data/reusables/README.md'
+      - '/data/variables/product.yml'
+      - '/data/variables/README.md'
+      - '/data/early-access'
+      - '/data/graphql'
+      - '/data/products.yml'
 
 # These end up as env vars used by the GitHub Actions workflow
 project_id_env: CROWDIN_PROJECT_ID

includes/article.html

@@ -67,7 +67,7 @@ <h3 id="in-this-article" class="f5 mb-2"><a class="link-gray-dark" href="#in-thi
 
     <div class="d-block border-top border-gray-light mt-4 markdown-body">
       {% include helpfulness %}
-      {% include contribution %}
+      {% unless page.hidden %}{% include contribution %}{% endunless %}
     </div>
   </article>
 </main>

includes/breadcrumbs.html

@@ -1,6 +1,10 @@
 <nav class="breadcrumbs f5" aria-label="Breadcrumb">
   {% for breadcrumb in breadcrumbs %}
+  {% if page.hidden %}
+  <span class="d-inline-block">{{breadcrumb[1].title}}</span>
+  {% else %}
   <a title="{{ breadcrumb[0]}}: {{breadcrumb[1].title}}" href="/{{currentLanguage}}{{breadcrumb[1].href}}" class="d-inline-block {% if breadcrumb[1].href == currentPathWithoutLanguage %}text-gray-light{% endif %}">
     {{breadcrumb[1].title}}</a>
+  {% endif %}
   {% endfor %}
 </nav>

includes/header.html

@@ -1,5 +1,7 @@
 <div class="border-bottom border-gray-light no-print">
+  {% unless error == '404' %}
   {% include header-notification %}
+  {% endunless %}
 
   <header class="container-xl px-3 px-md-6 pt-3 pb-2 position-relative d-flex flex-justify-between width-full {% if error == '404' %} d-md-none {% endif %}">
 

includes/sidebar-specific-product.html

@@ -9,7 +9,9 @@
 {% assign product = siteTree[currentLanguage][currentVersion].products[currentProduct] %}
 {% include all-products-link %}
 <li title="{{product.title}}" class="sidebar-product mb-2">
+  {% unless page.hidden %}
   <a href="/{{currentLanguage}}{{product.href}}" class="pl-4 pr-5 pb-1 f4">{{ product.title }}</a>
+  {% endunless %}
 </li>
 <ul class="sidebar-categories list-style-none">
   {% for category in product.categories %}

lib/algolia/find-indexable-pages.js

@@ -3,8 +3,10 @@ const loadPages = require('../pages')
 module.exports = async function findIndexablePages () {
   const allPages = await loadPages()
   const indexablePages = allPages
-    // exclude pages that are part of WIP products
-    .filter(page => !page.parentProduct || !page.parentProduct.wip)
+    // exclude hidden pages
+    .filter(page => !page.hidden)
+    // exclude pages that are part of WIP or hidden products
+    .filter(page => !page.parentProduct || !page.parentProduct.wip || page.parentProduct.hidden)
     // exclude index homepages
     .filter(page => !page.relativePath.endsWith('index.md'))