Transfering old docs site

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,2 @@
+- Did you remember to add a trailing slash if you added permalink frontmatter?
+- If you wrote a new blog post, have you added `redirect_from` in frontmatter?

.github/crush-pics/config.json

@@ -0,0 +1,4 @@
+{
+    "compression_mode": "lossless",
+    "strip_tags": false
+}

.github/links-to-fix.md

@@ -0,0 +1 @@
+All links are valid, nothing to see here.

.github/refresh-roadmap/refresh-roadmap.rb

@@ -0,0 +1,112 @@
+require 'uri'
+require 'net/http'
+require 'json'
+require 'yaml'
+
+def slugify(str)
+  str.downcase.strip.gsub(' ', '-').gsub(/[^\w-]/, '')
+end
+
+# Used to standardize the description format.
+def add_period_if_missing(string)
+  terminal_punctuation = [".", "!", "?"].freeze
+  string << "." unless string.end_with?(*terminal_punctuation)
+  string
+end
+
+# Removes Ruby symbol colons from keys (for YAML)
+def clear_keys(hash)
+  hash.map do |k, v|
+    k = k.to_s
+    if v.is_a?(Hash)
+      v = clear_keys(v)
+    elsif v.is_a?(Array)
+      v = v.map do |item|
+        i = clear_keys(item) if item.is_a?(Hash)
+        i
+      end
+    end
+
+    [k, v]
+  end.to_h
+end
+
+# Check for ENV vars
+["NOTION_TOKEN", "NOTION_DB_ID", "TARGET_PATH"].each do |v|
+  raise "Need to provide #{v} as an environment variable for this to work." if ENV[v].nil?
+end
+
+# Preps the request
+uri = URI("https://api.notion.com/v1/databases/#{ENV['NOTION_DB_ID']}/query")
+http = Net::HTTP.new(uri.host, uri.port)
+http.use_ssl = true
+
+request = Net::HTTP::Post.new(uri.request_uri)
+request["Authorization"] = "Bearer #{ENV['NOTION_TOKEN']}"
+request["Notion-Version"] = "2022-06-28"
+request["Accept"] = "application/json"
+request["Content-Type "] = "application/json"
+response = http.request(request)
+
+# If it's not a failure
+if response.is_a?(Net::HTTPSuccess)
+  puts "Roadmap data loaded. Processing..."
+
+  # Parses the response
+  content = JSON.parse(response.body)
+
+  # Preps the object to be serialized later
+  output = {
+    :now => [],
+    :soon => [],
+    :later => []
+  }
+
+  # Maps each row to a column, with properly transformed properties
+  content["results"].each do |row|
+    group = nil
+    entry = {}
+
+    row["properties"].each_pair do |name, val|
+      case name
+      when "Status"       then group = slugify(row["properties"]["Status"]["select"]["name"]).to_sym # Target for later
+      when "Title"        then entry[:title] = val["title"][0]["text"]["content"]
+      when "Description"  then entry[:description] = add_period_if_missing(val["rich_text"][0]["text"]["content"]) unless val["rich_text"].empty?
+      when "Release"      then entry[:release] = val["select"]["name"] unless val["select"].empty?
+      when "Paid"         then entry[:paid] = val["checkbox"]
+      end
+    end
+
+    output[group] = [] if output[group].nil?
+    output[group] << entry
+  end
+
+  # Only select the statuses we need for the roadmap
+  output.select! { |key, _| [:now, :soon, :later].include?(key) }
+
+  # Sort by paid, then alphabetically by title
+  [:now, :soon, :later].each do |group|
+    output[group].sort_by! { |entry| [entry[:paid] ? 0 : 1, entry[:title]] }
+  end
+
+  # Add one-by-two class to now, soon, and later
+  [:now, :soon, :later].each do |group|
+    # The `one-by-two` class is used to style these two sections
+    output[group].each do |entry|
+      entry[:class] = "one-by-two"
+    end
+  end
+
+  # Emtpy the target file and write the serialized YAML to it
+  output = clear_keys(output)
+  File.open(ENV['TARGET_PATH'], 'w') do |file|
+    file.truncate 0
+    file.write output.to_yaml
+  end
+
+  # Call it a day
+  puts "Roadmap data written to #{ENV['TARGET_PATH']}."
+else
+  # This should prevent a broken roadmap version to be checked in
+  raise "Could not get database from Notion"
+end

.github/stale.yml

@@ -0,0 +1,20 @@
+# For now we want to only check for stale pull requests
+only: pulls
+
+# Number of days of inactivity before an issue becomes stale
+daysUntilStale: 60
+
+# Number of days of inactivity before a stale issue is closed
+daysUntilClose: 7
+
+# Issues with these labels will never be considered stale
+exemptLabels:
+  - pinned
+  - security
+# Comment to post when marking an issue as stale. Set to `false` to disable
+markComment: >
+   This issue was automatically marked as stale due to a lack of recent activity.
+   If you'd like to revive it, please comment or update as requested!
+
+# Comment to post when closing a stale issue. Set to `false` to disable
+closeComment: false

.github/workflows/cd-jekyll.yml

@@ -0,0 +1,68 @@
+name: Deploy Jekyll site to Pages
+
+on:
+  push:
+    branches: ["master", "transfering_old_docs_site"] # run it from this branch, for faster iteration
+
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
+# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  # Build job
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Setup Ruby # uses version from .ruby-version
+        uses: ruby/setup-ruby@354a1ad156761f5ee2b7b13fa8e09943a5e8d252 # v1.179.0
+        with:
+          bundler-cache: true # runs 'bundle install' and caches installed gems automatically
+          cache-version: 0 # Increment this number if you need to re-download cached gems
+      - name: Setup Pages
+        id: pages
+        uses: actions/configure-pages@v5
+      - name: Build with Jekyll
+        # Outputs to the './_site' directory by default
+        run: bundle exec jekyll build --baseurl "${{ steps.pages.outputs.base_path }}"
+        env:
+          JEKYLL_ENV: production
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+      - name: Install Minifiers
+        run: npm install -g uglify-js csso-cli
+      - name: Minify JavaScript
+        run: |
+          find _site -name "*.js" -exec uglifyjs --compress --mangle -o {} -- {} \;
+      - name: Minify CSS
+        run: |
+          find _site -name "*.css" -exec csso --input {} --output {} \;
+      - name: Upload artifact
+        # Automatically uploads an artifact from the './_site' directory by default
+        uses: actions/upload-pages-artifact@v3
+
+  # Deployment job
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
+

.github/workflows/ci-jekyll.yml

@@ -0,0 +1,60 @@
+name: Jekyll site CI
+
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master
+  # `refresh-docs.yml` cannot trigger workflows with its `GITHUB_TOKEN` except through an explicit `workflow_dispatch`
+  # (cf. https://docs.github.com/en/actions/security-guides/automatic-token-authentication#using-the-github_token-in-a-workflow):
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-22.04
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Set up Ruby # uses version from .ruby-version
+        uses: ruby/setup-ruby@d5fb7a202fc07872cb44f00ba8e6197b70cb0c55 # v1.179.0
+        with:
+          bundler-cache: true
+
+      - name: Install dependencies
+        run: bundle install
+
+      - name: Setup Node
+        uses: actions/setup-node@v2
+        with:
+          node-version: 14
+          cache: "yarn"
+
+      - name: Install packages
+        run: yarn
+
+      - name: "Lint markdown"
+        run: "yarn lint-markdown"
+
+      - name: "Lint styles"
+        run: "yarn lint-styles"
+
+      - name: "Validate links"
+        run: "yarn lint-links"
+
+      - name: "Lint scripts"
+        run: "yarn lint-scripts"
+
+      - name: Build Jekyll Site
+        env:
+          JEKYLL_ENV: staging
+          NODE_ENV: production
+        run: "script/build"
+
+      - name: "Check all links"
+        run: "script/links"

.github/workflows/crush-pics.yml

@@ -0,0 +1,21 @@
+name: Crush images
+on:
+  pull_request:
+    branches:
+      - master
+    paths:
+      - '**.jpg'
+      - '**.jpeg'
+      - '**.png'
+      - '**.gif'
+# jobs:
+#   crush:
+#     runs-on: ubuntu-22.04
+#     steps:
+#       - name: Checkout
+#         uses: actions/checkout@v2
+#       - name: Crush images
+#         uses: crush-pics/crush-pics-github-action@master
+#         with:
+#           repo-token: ${{ secrets.GITHUB_TOKEN }}
+#           api-key: ${{ secrets.CRUSH_PICS_API_KEY }}

.github/workflows/links.yml

@@ -0,0 +1,39 @@
+name: Links
+
+on:
+  repository_dispatch:
+  workflow_dispatch:
+  schedule:
+    - cron: "0 0 * * 0"
+
+jobs:
+  build:
+    runs-on: ubuntu-22.04
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Set up Ruby # uses version from .ruby-version
+        uses: ruby/setup-ruby@d5fb7a202fc07872cb44f00ba8e6197b70cb0c55 # v1.179.0
+        with:
+          bundler-cache: true
+
+      - name: Install dependencies
+        run: bundle install
+
+      - name: Build Jekyll Site
+        env:
+          JEKYLL_ENV: staging
+        run: "script/build"
+
+      - name: "Check all links"
+        id: htmlproofer
+        run: "script/links > ./.github/links-to-fix.md"
+
+      - name: Create Issue From File
+        if: steps.htmlproofer.outputs.exit_code != 0
+        uses: peter-evans/create-issue-from-file@v5
+        with:
+          title: Link Checker Report
+          content-filepath: ./.github/links-to-fix.md
+          assignees: jeff-bruemmer
+

.github/workflows/refresh-docs.yml

@@ -0,0 +1,41 @@
+name: "Refresh docs"
+on:
+  schedule:
+    - cron: "0 0 * * 1-5"
+    # Run every hour so we can test properly
+    # - cron: "0 */1 * * 1-5"
+
+jobs:
+  update-latest-and-master-docs:
+    runs-on: ubuntu-22.04
+    steps:
+      - uses: actions/checkout@v3
+      - name: Install dependencies
+        run: yarn install --frozen-lockfile --prefer-offline
+      - name: Update docs
+        run: |
+          ./script/docs-update
+          ./script/docs master --set-version master
+      - name: Create a pull request
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          if git diff --quiet ; then
+            echo "No changes to commit."
+          else
+            git config user.email "[email protected]"
+            git config user.name "Metabase Docs bot"
+            update_branch="docs-update-${{ github.run_number }}"
+            git switch --create "${update_branch}"
+            git add .
+            git commit \
+              --author="Metabase Docs bot <[email protected]>" \
+              --message="Update master and latest docs"
+            git push --force -u origin "${update_branch}"
+            gh pr create --title "Refresh docs (nightly)" --body ""
+            # `GITHUB_TOKEN` cannot trigger workflows except through an explicit `workflow_dispatch`
+            # (cf. https://docs.github.com/en/actions/security-guides/automatic-token-authentication#using-the-github_token-in-a-workflow),
+            # thus creating the pull request above does not cause any workflow to run.
+            # Trigger the workflow manually:
+            gh workflow run --ref "${update_branch}" ci-jekyll.yml
+          fi