diff --git a/.codespellrc b/.codespellrc
deleted file mode 100644
index 0d8b8bc2ad..0000000000
--- a/.codespellrc
+++ /dev/null
@@ -1,2 +0,0 @@
-[codespell]
-ignore-words=.codespell-ignore
diff --git a/.gitignore b/.config/.gitignore
similarity index 50%
rename from .gitignore
rename to .config/.gitignore
index 18360dd76d..22c18e9a85 100644
--- a/.gitignore
+++ b/.config/.gitignore
@@ -1,10 +1,5 @@
.*.swp
.DS_Store
-.bundle/
-*.html
-.jekyll*
-.sass-cache/
-_site/
node_modules
output.log
site
diff --git a/.config/Dockerfile b/.config/Dockerfile
new file mode 100644
index 0000000000..0dbb796b31
--- /dev/null
+++ b/.config/Dockerfile
@@ -0,0 +1,36 @@
+# This installs reviewdoc, mkdocs and remark for convenient usage in pre-commit hooks and Github actions.
+
+FROM node:16-alpine
+
+ENV REVIEWDOG_VERSION=v0.13.1
+
+RUN \
+ apk add --update \
+ ca-certificates \
+ bash \
+ git \
+ openssh \
+ python3 \
+ python3-dev \
+ py3-pip \
+ build-base
+
+SHELL ["/bin/bash", "-o", "pipefail", "-c"]
+RUN wget -O - -q https://raw.githubusercontent.com/reviewdog/reviewdog/master/install.sh | sh -s -- -b /usr/local/bin/ ${REVIEWDOG_VERSION}
+
+# Install mkdocs and dependencies.
+COPY requirements.txt /usr/src/
+RUN pip3 install -r /usr/src/requirements.txt
+
+# Install remark and dependencies.
+COPY remark/* /usr/src/
+RUN yarn install --production --non-interactive --cwd /usr/src && \
+ yarn cache clean --force --cwd /usr/src \
+ mkdir /src
+ENV PATH="/usr/src/node_modules/.bin:${PATH}"
+
+COPY scripts/*.sh /usr/bin/
+WORKDIR /src
+
+ENTRYPOINT ["/bin/bash"]
+CMD []
diff --git a/.config/action.yml b/.config/action.yml
new file mode 100644
index 0000000000..2d966c0b26
--- /dev/null
+++ b/.config/action.yml
@@ -0,0 +1,16 @@
+name: "Run repo specific lint tools"
+description: "Runs repo specific lint tools on pull requests for documentation projects."
+author: "civicactions"
+inputs:
+ github_token:
+ description: "GITHUB_TOKEN."
+ required: true
+ default: ${{ github.token }}
+ command:
+ description: "Command to run"
+ required: true
+runs:
+ using: "docker"
+ image: "Dockerfile"
+ args:
+ - ${{ inputs.command }}
diff --git a/.codespell-ignore b/.config/codespell-ignore
similarity index 100%
rename from .codespell-ignore
rename to .config/codespell-ignore
diff --git a/.config/codespellrc b/.config/codespellrc
new file mode 100644
index 0000000000..d0ee1d42b6
--- /dev/null
+++ b/.config/codespellrc
@@ -0,0 +1,2 @@
+[codespell]
+ignore-words=.config/codespell-ignore
diff --git a/.config/mkdocs.yml b/.config/mkdocs.yml
new file mode 100644
index 0000000000..6ffbf49ae3
--- /dev/null
+++ b/.config/mkdocs.yml
@@ -0,0 +1,184 @@
+site_name: CivicActions Guidebook - Beta
+repo_url: https://github.com/CivicActions/handbook/
+site_url: https://handbook.civicactions.com/en/latest/
+docs_dir: ../docs
+theme:
+ name: material
+ features:
+ - navigation.tabs
+ - navigation.indexes
+ #- navigation.expand
+ favicon: img/favicon.ico
+ logo: img/ca-logo-white.svg
+ palette:
+ # Palette toggle for light mode
+ - scheme: default
+ toggle:
+ icon: material/brightness-7
+ name: Switch to dark mode
+ # Palette toggle for dark mode
+ - scheme: slate
+ toggle:
+ icon: material/brightness-4
+ name: Switch to light mode
+markdown_extensions:
+ - toc:
+ title: On this page
+plugins:
+ - search
+extra_css:
+ - css/extra.css
+extra_javascript:
+ #- js/extra.js
+ # Read the Docs requires JQuery for its JavaScript code to inject the flyout
+ # menu. Material for MkDocs does not come with JQuery.
+ - "https://code.jquery.com/jquery-3.6.2.min.js"
+# Navigation of the entire site is managed below, both the main menu items and their child pages.
+nav:
+ - Home: index.md
+ - About CivicActions:
+ - Mission and values: 020-about-us/mission-values.md
+ - Culture: 020-about-us/culture.md
+ - Diversity, Equity, Inclusion, and Accessibility (DEIA):
+ - DEIA at CivicActions: 050-how-we-work/diversity-equity-inclusion/purpose.md
+ - Defining DEIA: 050-how-we-work/diversity-equity-inclusion/defining-dei.md
+ - Affinity channels: 050-how-we-work/diversity-equity-inclusion/affinity-channels.md
+ - DEIA - Get involved: 050-how-we-work/diversity-equity-inclusion/deia-get-involved.md
+ - Resources: 050-how-we-work/diversity-equity-inclusion/resources.md
+ - Our structure:
+ - Departments, projects, practice areas, and pods: 050-how-we-work/organization.md
+ - Organizational structure: 020-about-us/org-structure.md
+ - Management team: 050-how-we-work/management-ops.md
+ - Background and history: 020-about-us/background-and-history.md
+ - Our annual summit: 030-policies/annual-retreat.md
+ - Employee benefits:
+ - Benefits policy (US employees): 040-employee-handbook-us/benefits-and-holidays.md
+ - Compensation (US employees): 040-employee-handbook-us/compensation.md
+ - Technology stipend policy (US employees): 040-employee-handbook-us/tech-stipend.md
+ - Benefits policy (Canadian employees): 045-employee-handbook-ca/benefits-and-holidays.md
+ - Technology stipend (Canadian employees): 045-employee-handbook-ca/tech-stipend.md
+ - Professional development: 030-policies/prodev.md
+ - Employee referral bonus program: 030-policies/employee-referral-bonus.md
+ - On-call stipends: 030-policies/on-call-stipend.md
+ - Company policies:
+ - Expenses: 030-policies/expenses.md
+ - Travel expenses and billing: 030-policies/travel-101.md
+ - Timesheets (Unanet): 050-how-we-work/tools/unanet.md
+ - Security Policy: 030-policies/security.md
+ - Employment policies (US employees):
+ - Employment: 040-employee-handbook-us/employment.md
+ - Introductory period: 040-employee-handbook-us/introductory-period.md
+ - Anti-harassment: 040-employee-handbook-us/anti-harassment-policies.md
+ - Covid 19 safety: 040-employee-handbook-us/covid19safety.md
+ - Code of conduct: 030-policies/code-of-conduct.md
+ - Workplace guidelines: 030-policies/workplace-guidelines.md
+ - Annual performance review: 030-policies/annual-review-process.md
+ - Performance management: 030-policies/performance-management.md
+ - Leaving Civicactions: 030-policies/leaving-civicactions.md
+ - Health, Safety and Security Policy: 030-policies/health-safety-security.md
+ - New hire orientation:
+ - Welcome to CivicActions!: 010-welcome-to-civicactions/welcome.md
+ - Buddy program: 010-welcome-to-civicactions/training/buddy-program.md
+ - Elevator pitch: 020-about-us/elevator-pitch.md
+ - Free and open source software (FOSS): 010-welcome-to-civicactions/training/intro-open-source.md
+ - Meetings and meeting tools: 010-welcome-to-civicactions/training/meetings-and-meeting-tools.md
+ - People planning: 010-welcome-to-civicactions/training/people-planning.md
+ - Security for everyone: 010-welcome-to-civicactions/training/security-training.md
+ - Training resources: 050-how-we-work/training-resources.md
+ - Video call best practices: 050-how-we-work/video-call-best-practices.md
+ - Virtual workplace basics: 050-how-we-work/virtual-workplace-basics.md
+ - Common practices and tools:
+ - Agile:
+ - Agile overview: 050-how-we-work/agile-overview.md
+ - Agile practice: 050-how-we-work/agile-practices/README.md
+ - Backlog refinement: 050-how-we-work/agile-practices/backlog-refinement.md
+ - Daily scrum calls: 050-how-we-work/agile-practices/daily-scrum-calls.md
+ - How to create tickets: 050-how-we-work/tools/tickets-cards.md
+ - Sprint cycle: 050-how-we-work/agile-practices/sprint-cycle.md
+ - Sprint demo: 050-how-we-work/agile-practices/sprint-demo.md
+ - Sprint planning meetings: 050-how-we-work/agile-practices/sprint-planning-meetings.md
+ - Sprint retrospectives: 050-how-we-work/agile-practices/sprint-retrospectives.md
+ - Balance scores: 050-how-we-work/balance-scores.md
+ - Gold Star Program: 050-how-we-work/gold-star-program.md
+ - Security awareness and tools:
+ - Awareness and tools: 100-security/awareness.md
+ - Setting up and using Yubikey:
+ - 100-security/yubikey/README.md
+ - Yubikey and Linux: 100-security/yubikey/linux.md
+ - Yubikey and Mac OS: 100-security/yubikey/macosx.md
+ - Drupal RMF support: 100-security/drupal-rmf-support.md
+ - Encryption: 100-security/encryption.md
+ - Incidents:
+ - Contingency plan: 100-security/contingency-plan.md
+ - Incident response checklist: 100-security/incident-response-checklist.md
+ - Incident response plan: 100-security/incident-response-plan.md
+ - Security incidents: 100-security/incidents.md
+ - Skills Base: 050-how-we-work/tools/skills-base.md
+ - Software and support:
+ - Internal technical support: 050-how-we-work/support.md
+ - Bookmarks: 050-how-we-work/bookmarks.md
+ - Email: 050-how-we-work/tools/email.md
+ - General contacts and listservs: 020-about-us/general-contacts-and-listservs.md
+ - Github: 050-how-we-work/tools/github.md
+ - Google Calendar: 050-how-we-work/tools/google-calendar.md
+ - Google Docs: 050-how-we-work/tools/google-docs.md
+ - Google Meet: 050-how-we-work/tools/google-hangouts.md
+ - Jira: 050-how-we-work/tools/jira.md
+ - Markdown: 050-how-we-work/tools/markdown.md
+ - Slack: 050-how-we-work/tools/slack.md
+ - Text editors: 050-how-we-work/tools/text-editors.md
+ - Trello: 050-how-we-work/tools/trello.md
+ - Zoom: 050-how-we-work/tools/zoom.md
+ - Telephone use: 050-how-we-work/tools/telephone.md
+ - Practice areas:
+ - About practice areas: 050-how-we-work/practice-areas/README.md
+ - Accessibility practice area: 050-how-we-work/practice-areas/accessibility-practice-area.md
+ - Design and research:
+ - Audience and outcomes guide: 110-ux/services/research/audiences-and-outcomes-guide.md
+ - Content audit guide: 110-ux/services/research/content-audit-guide.md
+ - Content modeling guide: 110-ux/services/design/content-modeling-guide.md
+ - Stakeholder interviews guide: 110-ux/services/research/stakeholder-interviews-guide.md
+ - Story mapping guide: 110-ux/services/research/story-mapping-guide.md
+ - Usability testing guide: 110-ux/services/research/usability-testing-guide.md
+ - User personas guide: 110-ux/services/research/user-personas-guide.md
+ - Engineering:
+ - Engineering calls: 060-engineering/README.md
+ - Accessibility: 060-engineering/accessibility.md
+ - Drupal practice area: 050-how-we-work/practice-areas/drupal-practice-area.md
+ - Drupal - contributed vs. custom development: 060-engineering/most-important-decision-in-developing-a-drupal-site-contributed-vs-custom-development.md
+ - Drupal developer tips for getting the most out of open source: 060-engineering/drupal-developer-tips-for-getting-the-most-out-of-open-source.md
+ - Git: 060-engineering/git.md
+ - Security and compliance: 060-engineering/security-compliance.md
+ - Tech Lead (TL) project role description: 060-engineering/tech-lead.md
+ - Help desk:
+ - Help desk support: 120-help-desk/helpdesk.md
+ - Project support and Agile: 120-help-desk/help-desk-agile.md
+ - Help desk working practices: 120-help-desk/working-practices.md
+ - Project management:
+ - Project manager role: 070-project-management/pm-role.md
+ - Guidelines for starting a new project: 070-project-management/starting-new-project.md
+ - Invoicing: 070-project-management/invoicing.md
+ - Onboarding a new project team member: 070-project-management/onboarding-new-project-team-member.md
+ - When your project gets a contractual Modification (MOD) or Extension: 070-project-management/mods-and-extentions.md
+ - Tracking contract expirations and renewals: 070-project-management/contract-expiration-tracking.md
+ - Tracking contractual requirements: 070-project-management/contractual-requirements.md
+ - Conflict resolution and growth mindset: 070-project-management/growth-mindset.md
+ - Leave Requests and Stepping Away: 070-project-management/leave-requests-and-stepping-away.md
+ - Having the hard conversations: 070-project-management/hard-conversations.md
+ - Listserv setup: 070-project-management/listserv-setup.md
+ - Offboarding a team member from a project: 070-project-management/project-offboarding.md
+ - Planning travel and onsite meetings: 070-project-management/planning-onsite-meetings.md
+ - Project calendar: 070-project-management/project-calendar.md
+ - Project folder structure: 070-project-management/project-folder.md
+ - Project Manager templates: 070-project-management/templates.md
+ - Project Manager training: 070-project-management/pm-training.md
+ - Project Management Unanet Tasks and Training Material: 070-project-management/pm-unanet-tasks.md
+ - Project Management Checklists: 070-project-management/project-management-checklists.md
+ - About this guidebook:
+ - How and when to contribute to the guidebook: 000-contributing/README.md
+ - Git workflow: 000-contributing/git-workflow.md
+ - GitHub actions: 000-contributing/github-actions.md
+ - Guidebook governance: 000-contributing/docs-governance.md
+ - Guidebook writing style: 000-contributing/writing-style-guide.md
+ - Markdown: 000-contributing/markdown.md
+ - License: LICENSE.md
diff --git a/.pre-commit-search-and-replace.yaml b/.config/pre-commit-search-and-replace.yaml
similarity index 70%
rename from .pre-commit-search-and-replace.yaml
rename to .config/pre-commit-search-and-replace.yaml
index 02e6d43e12..ac7f5a4ade 100644
--- a/.pre-commit-search-and-replace.yaml
+++ b/.config/pre-commit-search-and-replace.yaml
@@ -1,3 +1,4 @@
+# These fix common "fancy" characters when pasting from word processors.
- search: "´"
replacement: "'"
- search: "‘"
diff --git a/lint/config/package.json b/.config/remark/package.json
similarity index 100%
rename from lint/config/package.json
rename to .config/remark/package.json
diff --git a/lint/config/remarkrc.problem b/.config/remark/remarkrc.problem
similarity index 100%
rename from lint/config/remarkrc.problem
rename to .config/remark/remarkrc.problem
diff --git a/lint/config/remarkrc.suggestion b/.config/remark/remarkrc.suggestion
similarity index 100%
rename from lint/config/remarkrc.suggestion
rename to .config/remark/remarkrc.suggestion
diff --git a/lint/config/retext.problem.js b/.config/remark/retext.problem.js
similarity index 100%
rename from lint/config/retext.problem.js
rename to .config/remark/retext.problem.js
diff --git a/lint/config/retext.suggestion.js b/.config/remark/retext.suggestion.js
similarity index 100%
rename from lint/config/retext.suggestion.js
rename to .config/remark/retext.suggestion.js
diff --git a/lint/config/yarn.lock b/.config/remark/yarn.lock
similarity index 100%
rename from lint/config/yarn.lock
rename to .config/remark/yarn.lock
diff --git a/.config/requirements.in b/.config/requirements.in
new file mode 100644
index 0000000000..9171172747
--- /dev/null
+++ b/.config/requirements.in
@@ -0,0 +1 @@
+mkdocs_material==8.5.11
diff --git a/.config/requirements.txt b/.config/requirements.txt
new file mode 100644
index 0000000000..1c526d1d59
--- /dev/null
+++ b/.config/requirements.txt
@@ -0,0 +1,59 @@
+#
+# This file is autogenerated by pip-compile with python 3.10
+# To update, run:
+#
+# pip-compile requirements.in
+#
+certifi==2022.12.7
+ # via requests
+charset-normalizer==2.1.1
+ # via requests
+click==8.1.3
+ # via mkdocs
+ghp-import==2.1.0
+ # via mkdocs
+idna==3.4
+ # via requests
+jinja2==3.1.2
+ # via
+ # mkdocs
+ # mkdocs-material
+markdown==3.3.7
+ # via
+ # mkdocs
+ # mkdocs-material
+ # pymdown-extensions
+markupsafe==2.1.1
+ # via jinja2
+mergedeep==1.3.4
+ # via mkdocs
+mkdocs==1.4.2
+ # via mkdocs-material
+mkdocs-material==8.5.11
+ # via -r requirements.in
+mkdocs-material-extensions==1.1.1
+ # via mkdocs-material
+packaging==21.3
+ # via mkdocs
+pygments==2.13.0
+ # via mkdocs-material
+pymdown-extensions==9.9
+ # via mkdocs-material
+pyparsing==3.0.9
+ # via packaging
+python-dateutil==2.8.2
+ # via ghp-import
+pyyaml==6.0
+ # via
+ # mkdocs
+ # pyyaml-env-tag
+pyyaml-env-tag==0.1
+ # via mkdocs
+requests==2.28.1
+ # via mkdocs-material
+six==1.16.0
+ # via python-dateutil
+urllib3==1.26.13
+ # via requests
+watchdog==2.2.0
+ # via mkdocs
diff --git a/lint/mkdocs.sh b/.config/scripts/mkdocs.sh
similarity index 56%
rename from lint/mkdocs.sh
rename to .config/scripts/mkdocs.sh
index 33c58c9a18..240421f459 100644
--- a/lint/mkdocs.sh
+++ b/.config/scripts/mkdocs.sh
@@ -5,5 +5,6 @@ set -euo pipefail
# Exclude info log messages for more concise output.
tmp_dir=$(mktemp -d -t mkdocs-XXXXXX)
-/usr/bin/mkdocs build --strict --site-dir "${tmp_dir}" 2>&1 | { grep -v '^INFO' || true; }
+/usr/bin/mkdocs build --config-file=.config/mkdocs.yml --strict --site-dir "${tmp_dir}" 2>&1 | { grep -v '^INFO' || true; }
rm -rf "${tmp_dir}"
+echo "mkdocs build successful"
diff --git a/lint/remark.sh b/.config/scripts/remark.sh
similarity index 91%
rename from lint/remark.sh
rename to .config/scripts/remark.sh
index 7de8a6be37..3fa57566b2 100755
--- a/lint/remark.sh
+++ b/.config/scripts/remark.sh
@@ -12,8 +12,8 @@ MASTER=master
if [[ -z ${LOCAL_MASTER} ]]; then
MASTER=origin/master
fi
-# Only check paths changed on branch to avoid excessive output.
-export REMARK_PATHS=$(git diff --diff-filter=AM --name-only "${MASTER}" | grep '^docs')
+# Only check paths changed on branch to avoid excessive output. Exclude CSS.
+export REMARK_PATHS=$(git diff --diff-filter=AM --name-only "${MASTER}" ':!docs/css/extra.css' | grep '^docs')
if [[ -n "${INPUT_GITHUB_TOKEN:-}" ]]; then
export REVIEWDOG_GITHUB_API_TOKEN="${INPUT_GITHUB_TOKEN}"
diff --git a/.github/workflows/codespell.yml b/.github/workflows/codespell.yml
index b2362f598c..33a7c83ee1 100644
--- a/.github/workflows/codespell.yml
+++ b/.github/workflows/codespell.yml
@@ -12,4 +12,4 @@ jobs:
- uses: codespell-project/actions-codespell@master
with:
path: docs
- ignore_words_file: .codespell-ignore
+ config: .config/codespellrc
diff --git a/.github/workflows/mkdocs.yml b/.github/workflows/mkdocs.yml
index 00cbeb77ae..672d8c1598 100644
--- a/.github/workflows/mkdocs.yml
+++ b/.github/workflows/mkdocs.yml
@@ -8,9 +8,11 @@ jobs:
mkdocs:
runs-on: ubuntu-latest
steps:
- - uses: actions/checkout@v2
- - name: Run mkdocs
- uses: docker://civicactions/handbook-lint:latest
+ - uses: actions/checkout@v1
with:
- entrypoint: /bin/bash
- args: mkdocs.sh
+ fetch-depth: 0
+ - name: Run mkdocs to check build.
+ uses: ./.config/
+ with:
+ github_token: ${{ secrets.GITHUB_TOKEN }}
+ command: mkdocs.sh
diff --git a/.github/workflows/reviewdog.yml b/.github/workflows/reviewdog.yml
index 90a103a789..4aeefb2fec 100644
--- a/.github/workflows/reviewdog.yml
+++ b/.github/workflows/reviewdog.yml
@@ -11,6 +11,7 @@ jobs:
with:
fetch-depth: 0
- name: Run remark-lint with reviewdog for documentation projects.
- uses: ./lint
+ uses: ./.config/
with:
github_token: ${{ secrets.GITHUB_TOKEN }}
+ command: remark.sh
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 0430be608e..be5784ffe1 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -34,11 +34,15 @@ repos:
hooks:
- id: search-and-replace
files: docs
+ args:
+ - "--config=.config/pre-commit-search-and-replace.yaml"
- repo: https://github.com/codespell-project/codespell
rev: v2.2.2
hooks:
- id: codespell
files: docs
+ args:
+ - "--config=.config/codespellrc"
- repo: https://github.com/pre-commit/mirrors-prettier
rev: v3.0.0-alpha.4
hooks:
diff --git a/.readthedocs.yaml b/.readthedocs.yaml
new file mode 100644
index 0000000000..9dccc22f25
--- /dev/null
+++ b/.readthedocs.yaml
@@ -0,0 +1,20 @@
+# .readthedocs.yaml
+# Read the Docs configuration file
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+# Required
+version: 2
+
+# Set the version of Python and other tools you might need
+build:
+ os: ubuntu-20.04
+ tools:
+ python: "3.9"
+
+mkdocs:
+ configuration: .config/mkdocs.yml
+
+# Optionally declare the Python requirements required to build your docs
+python:
+ install:
+ - requirements: .config/requirements.txt
diff --git a/docs/css/extra.css b/docs/css/extra.css
index abeaafdd99..7952ddb38f 100644
--- a/docs/css/extra.css
+++ b/docs/css/extra.css
@@ -1,63 +1,19 @@
-h1,
-h2,
-h3,
-h4,
-h5,
-h6,
-p,
-li,
-blockquote {
- font-family: "Ubuntu", sans-serif;
-}
-h1,
-h2,
-h3,
-h4,
-h5,
-h6 {
- font-weight: 900;
-}
-.wy-nav-side {
- background: #002f43;
-}
-.wy-nav-content {
- color: #002f43;
-}
-.wy-nav-content a,
-.wy-nav-content a:visited {
- color: #db1b3b;
-}
-.wy-menu-vertical ul.subnav li.current span {
- color: #484849;
-}
-.wy-menu-vertical span {
- color: #edf0f2;
- font-weight: bold;
-}
-.wy-menu-vertical a:active {
- background-color: #db1b3b;
-}
-.wy-menu-vertical a:hover {
- color: #e7e7e7;
-}
-.wy-menu-vertical li.current a {
- color: #404040;
-}
-.wy-side-nav-search {
- background-color: #db1b3b;
-}
-.wy-side-nav-search > div.version {
- color: #fff7f6;
-}
-code {
- color: #9d3429;
-}
-a code {
- color: #1e5d86;
-}
-a:hover code {
- color: #1f5d86;
-}
-footer {
- color: #545454;
+:root {
+ --md-primary-fg-color: #a23737;
+ --md-accent-fg-color: #3b4eb7;
+}
+[data-md-color-scheme="slate"] {
+ --md-typeset-a-color: #ffa8a8;
+ --md-accent-fg-color: #afbbff;
+}
+.md-search__form {
+ background-color: #d83933;
+}
+/* The Read the Docs flyout is formatted with a font-size that is 90% of the
+body's. Material for MkDocs has a body font-size that is 0.5rem. This font-size
+will result in the flyout having a font-size of 0.7rem, consistent with the
+font-size of other elements in the theme.
+*/
+.rst-versions {
+ font-size: 0.777778rem;
}
diff --git a/docs/img/ca-logo-white.svg b/docs/img/ca-logo-white.svg
new file mode 100644
index 0000000000..6030749076
--- /dev/null
+++ b/docs/img/ca-logo-white.svg
@@ -0,0 +1 @@
+
diff --git a/docs/index.md b/docs/index.md
index 3a97d5aedf..6ebf021284 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -1,4 +1,10 @@
-# CivicActions Handbook
+---
+hide:
+ - navigation
+ - toc
+---
+
+# CivicActions Guidebook
[![Documentation Status](https://readthedocs.org/projects/civicactions-handbook/badge/?version=latest)](https://handbook.civicactions.com/en/latest/?badge=latest)
@@ -11,9 +17,9 @@ Lafayette, CA 94549
888.714.7388 | fax
civicactions.com
-### Handbook Purpose
+### Guidebook Purpose
-This Handbook has been prepared to describe the CivicActions philosophy, working methods and processes, employment practices, policies, benefits, and conduct we expect from members of our team.
+This Guidebook has been prepared to describe the CivicActions philosophy, working methods and processes, employment practices, policies, benefits, and conduct we expect from members of our team.
## License
diff --git a/lint/Dockerfile b/lint/Dockerfile
deleted file mode 100644
index e36ff9536f..0000000000
--- a/lint/Dockerfile
+++ /dev/null
@@ -1,30 +0,0 @@
-FROM node:16-alpine
-
-ENV REVIEWDOG_VERSION=v0.13.1
-
-RUN \
- apk add --update \
- ca-certificates \
- bash \
- git \
- openssh \
- python3 \
- python3-dev \
- py3-pip \
- build-base && \
- pip3 install mkdocs mdx_truly_sane_lists
-
-SHELL ["/bin/bash", "-o", "pipefail", "-c"]
-RUN wget -O - -q https://raw.githubusercontent.com/reviewdog/reviewdog/master/install.sh | sh -s -- -b /usr/local/bin/ ${REVIEWDOG_VERSION}
-
-COPY *.sh /usr/bin/
-
-COPY config/* /usr/src/
-RUN yarn install --production --non-interactive --cwd /usr/src/ && \
- yarn cache clean --force --cwd /usr/src/ \
- mkdir /src
-ENV PATH="/usr/src/node_modules/.bin:${PATH}"
-WORKDIR /src
-
-ENTRYPOINT ["/bin/bash"]
-CMD []
diff --git a/lint/action.yml b/lint/action.yml
deleted file mode 100644
index 3a5e09562b..0000000000
--- a/lint/action.yml
+++ /dev/null
@@ -1,13 +0,0 @@
-name: "Run remark-lint with reviewdog"
-description: "🐶 Run remark-lint with reviewdog on pull requests for documentation projects."
-author: "civicactions"
-inputs:
- github_token:
- description: "GITHUB_TOKEN."
- required: true
- default: ${{ github.token }}
-runs:
- using: "docker"
- image: "Dockerfile"
- args:
- - remark.sh
diff --git a/mkdocs.yml b/mkdocs.yml
deleted file mode 100644
index 751ed34536..0000000000
--- a/mkdocs.yml
+++ /dev/null
@@ -1,17 +0,0 @@
-site_name: CivicActions Handbook
-repo_url: https://github.com/CivicActions/handbook/
-site_url: https://handbook.civicactions.com/en/latest/
-theme:
- name: readthedocs
- highlightjs: true
- hljs_languages:
- - yaml
- - rust
-plugins:
- - search
-extra_css:
- - css/extra.css
-extra_javascript:
- - js/extra.js
-markdown_extensions:
- - mdx_truly_sane_lists
diff --git a/requirements.txt b/requirements.txt
deleted file mode 100644
index 65f7594229..0000000000
--- a/requirements.txt
+++ /dev/null
@@ -1 +0,0 @@
-mdx_truly_sane_lists==1.2