New mkdocs+material site

.github/CODEOWNERS

@@ -0,0 +1,13 @@
+# These rules follow a last-match behavior.
+
+# default (if nothing else matches)
+* @ahouseholder @ehatleback
+
+# any markdown file in docs
+/docs/**/*.md @ahouseholder @ehatleback
+
+# website config
+mkdocs.yml @ahouseholder
+
+# github setup
+/.github/ @ahouseholder @sei-vsarvepalli

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,41 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: bug
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Desktop (please complete the following information):**
+
+- OS: [e.g. iOS]
+- Browser [e.g. chrome, safari]
+- Version [e.g. 22]
+
+**Smartphone (please complete the following information):**
+
+- Device: [e.g. iPhone6]
+- OS: [e.g. iOS8.1]
+- Browser [e.g. stock browser, safari]
+- Version [e.g. 22]
+
+**Additional context**
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -2,7 +2,7 @@
 name: Feature request
 about: Suggest an idea for this project
 title: ''
-labels: ''
+labels: enhancement
 assignees: ''
 
 ---

.github/ISSUE_TEMPLATE/question.md

@@ -0,0 +1,13 @@
+---
+name: Question
+about: Ask the CERT Guide to CVD team a question
+title: Add a concise title for your question
+labels: question
+assignees: ''
+
+---
+
+*Note:* Questions for the CERT Guide to CVD team can be asked here in the form of an issue.
+More general questions directed at the CERT Guide to CVD user community
+might be a better fit in the [Q&A](https://github.com/CERTCC/CERT-Guide-to-CVD/discussions/categories/q-a) category of our
+[Discussions](https://github.com/CERTCC/CERT-Guide-to-CVD/discussions) area.

.github/dependabot.yml

@@ -0,0 +1,23 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+
+version: 2
+updates:
+  - package-ecosystem: "pip" # See documentation for possible values
+    directory: "/" # Location of package manifests
+    schedule:
+      interval: "weekly"
+    groups:
+      mkdocs:
+        patterns:
+        - "mkdocs*"
+        update-types:
+        - "minor"
+        - "patch"
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+

.github/pull_request_template.md

@@ -0,0 +1 @@
+*Contributions to this project are subject to the terms listed in [CONTRIBUTING.md](CONTRIBUTING.md).*

.github/workflows/deploy_site.yml

@@ -0,0 +1,62 @@
+# Simple workflow for deploying static content to GitHub Pages
+name: Deploy static content to Pages
+
+on:
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+  # Runs on pushes targeting the default branch
+  push:
+    branches:
+        - publish
+
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+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:
+  # Single deploy job since we're just deploying
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -r requirements.txt
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+
+      - name: Build Site
+        run: |
+          mkdocs build --verbose --clean --config-file mkdocs.yml       
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          # Upload entire repository
+          path: 'site'
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.github/workflows/linkchecker.yml

@@ -0,0 +1,34 @@
+name: Link Checker
+on:
+  pull_request:
+    paths:
+      - '**/*.md'
+      - .github/workflows/linkchecker.yml
+  workflow_dispatch:
+
+jobs:
+  linkcheck:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.10'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -r requirements.txt
+          python -m pip install linkchecker
+#          python -m pip install -e .
+
+      - name: Build Site
+        run: |
+          mkdocs build --verbose --clean --config-file mkdocs.yml       
+
+      - name: Check links
+        run: |
+          linkchecker site/index.html

.github/workflows/lint_md_all.yml

@@ -0,0 +1,15 @@
+name: "Lint Markdown (all)"
+
+on: 
+  workflow_dispatch:
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+    - uses: DavidAnson/markdownlint-cli2-action@v16
+      with:
+        globs: |
+          *.md
+          !test/*.md

.github/workflows/lint_md_changes.yml

@@ -0,0 +1,26 @@
+name: "Lint Markdown (Changes)"
+on:
+  pull_request:
+    paths:
+      - '**/*.md'
+      - .github/workflows/lint_md_changes.yml
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+    - uses: tj-actions/changed-files@v44
+      id: changed-files
+      with:
+        files: '**/*.md'
+        separator: ","
+    - uses: DavidAnson/markdownlint-cli2-action@v16
+      if: steps.changed-files.outputs.any_changed == 'true'
+      with:
+        globs: ${{ steps.changed-files.outputs.all_changed_files }}
+        separator: ","
+        config: .markdownlint-cli2.yaml
+

.gitignore

@@ -0,0 +1 @@
+tmp/*

.markdownlint-cli2.yaml

@@ -0,0 +1,29 @@
+config:
+  # 0004 Unordered List style
+  # Force dash style for unordered lists
+  "MDOO4":
+    style: "dash"
+  # 013 Line length
+  # Disabled because we have a lot of long lines. We should fix this eventually.
+  "MD013": false
+  # 033 Inline HTML
+  # Disabled because we use inline HTML (<br/> in table cells for example)
+  "MD033": false
+  # 041 First line in file should be a top level header
+  # Disabled because we use `include-markdown` plugin for merging markdown files
+  "MD041": false
+  # 046 Code block style
+  # Disabled because mkdocs-material uses indented blocks for admonitions
+  "MD046": false
+  # 049 emphasis style
+  # Force asterisk style for emphasis
+  "MD049":
+    style: "asterisk"
+  # 050 strong style
+  # Force asterisk style for strong
+  "MD050":
+    style: "asterisk"
+  # 051 Link fragments should be valid
+  # Disabled because conversion from TeX to markdown produces invalid links
+  # We might eventually be able to re-enable this one.
+  "MD051": false

CONTRIBUTING.md

@@ -0,0 +1,109 @@
+# Contributing to the CERT Guide to CVD
+
+Thank you for your interest in contributing to the
+**CERT Guide to Coordinated Vulnerability Disclosure**
+project (“We” or “Us”).
+By making any Contribution to this project, you agree to the terms outlined below.  
+
+**IF YOU DO NOT AGREE TO THESE TERMS, DO NOT SUBMIT ANY CONTRIBUTION TO THIS PROJECT.**
+
+## TERMS OF SUBMISSION (“Agreement”)
+
+### 1. Definitions
+
+- "**You**" means the individual who Submits a Contribution to Us.
+- "**Contribution**" means any work of authorship, including but not limited to source code, object code, patch, tool,
+   sample, graph, specification, manual documentation, that is Submitted by You to Us in which You own or assert
+   ownership of the Copyright.
+- "**Copyright**" means all rights protecting works of authorship owned or controlled by You, including copyright, moral
+   and neighboring rights, as appropriate, for the full term of their existence including any extensions by You.
+- "**Material**" means the work of authorship which is made available by Us to third parties. When this Agreement covers
+   more than one software project, the Material means the work of authorship to which the Contribution was Submitted.
+   After You Submit the Contribution, it may be included in the Material.
+- "**Submit**" means any form of electronic, verbal, or written communication sent to Us or our representatives, including
+   but not limited to electronic mailing lists, source code control systems, and issue tracking systems that are managed
+   by, or on behalf of, Us for the purpose of discussing and improving the Material, but excluding communication that is
+   conspicuously marked or otherwise designated in writing by You as "Not a Contribution."
+- "**Submission Date**" means the date on which You Submit a Contribution to Us.
+- "**Effective Date**" means the date You first Submit a Contribution to Us, whichever is earlier.
+- "**Media**" means any portion of a Contribution which is not software.
+
+### 2. Grant of Rights
+
+#### 2.1 Copyright License
+
+**(a)** You retain ownership of the Copyright in Your Contribution and have the same rights to use or license the
+Contribution which You would have had without entering into the Agreement.
+
+**(b)** To the maximum extent permitted by the relevant law, You grant to Us a perpetual, worldwide, non-exclusive,
+transferable, royalty-free, irrevocable license, with the right to sublicense such rights through multiple tiers of
+sublicensees, to reproduce, modify, display, perform and distribute the Contribution as part of the Material;
+provided that this license is conditioned upon compliance with Section 2.2.
+
+#### 2.2 Outbound License
+
+Based on the grant of rights in Section 2.1, if We include Your Contribution in a Material,
+We may license the Contribution under any license, including copyleft, permissive, commercial, or proprietary licenses.
+As a condition on the exercise of this right, We agree to also license the Contribution under the terms of the license
+or licenses which We are using for the Material on the Submission Date.
+
+#### 2.3 Moral Rights
+
+If moral rights apply to the Contribution, to the maximum extent permitted by law, You waive and agree not to assert
+such moral rights against Us or our successors in interest, or any of our licensees, either direct or indirect.
+
+#### 2.4 Our Rights
+
+You acknowledge that We are not obligated to use Your Contribution as part of the Material and may decide to include any
+Contribution We consider appropriate.
+
+#### 2.5 Reservation of Rights
+
+Any rights not expressly assigned or licensed under this section are expressly reserved by You.
+
+### 3. General Terms
+
+**3.1** You warrant that:
+
+**(a)** You have the legal authority to enter into this Agreement.
+
+**(b)** You own all rights, including but not limited to Copyright, covering the Contribution which are required to grant
+the rights under Section 2. To the extent the Contribution incorporates text passages, figures, data or other
+material from the works of others, You warrant that you have obtained any necessary permissions to make this
+Contribution.
+
+**(c)** The grant of rights under Section 2 does not violate any grant of rights which You have made to third parties,
+including Your employer. If You are an employee, You warrant that Your employer has approved this Agreement. If You
+are less than eighteen years old, Your parent or guardian must sign a printed version of this Agreement and send it
+to <permission@sei.cmu.edu>.
+
+**(d)** You shall make each Contribution in full compliance with U.S. export control laws.
+
+**3.2** You agree to notify Us if You become aware of any circumstance that would make any of the foregoing warranties inaccurate in any respect.
+
+**3.3** You agree to indemnify and hold Us harmless from any damage or expense that may arise in the event of a breach of
+any of the warranties set forth above.
+
+**3.4** You agree that We may publicly disclose your participation in this project and the fact that you agreed to the terms
+of this Agreement.
+
+### 4. Miscellaneous
+
+**4.1** This Agreement will be governed by and construed in accordance with the laws of Pennsylvania excluding its
+conflicts of law provisions.
+
+**4.2** This Agreement sets out the entire agreement between You and Us for Your Contributions to Us and overrides all
+other agreements or understandings.
+
+**4.3** If You or We assign the rights or obligations received through this Agreement to a third party, as a condition of the assignment, that third party must agree in writing to abide by all the rights and obligations in the Agreement.
+
+**4.4** The failure of either party to require performance by the other party of any provision of this Agreement in one
+situation shall not affect the right of a party to require such performance at any time in the future. A waiver of
+performance under a provision in one situation shall not be considered a waiver of the performance of the provision
+in the future or a waiver of the provision in its entirety.
+
+**4.5** If any provision of this Agreement is found by a court of competent jurisdiction to be void and unenforceable,
+such provision will be replaced to the extent possible with a provision that comes closest to the meaning of the
+original provision and which is enforceable. The terms and conditions set forth in this Agreement shall apply
+notwithstanding any failure of essential purpose of this Agreement or any limited remedy to the maximum extent
+possible under law.