dsql
823aa7708a
Collapse the deploy sub-pages back into one deploy.md (tabs, not separate pages), add a working mermaid flow diagram, and rework the top per feedback. - Mermaid: enable via superfences fence_div_format (the fence_code_format <pre><code> wrapper broke mermaid's render — div format fixes it); vendor mermaid.min.js locally (no CDN dependency for a self-hosted site) + a small init that renders each block once and survives instant-nav. - Content tabs Compose / Dockerfile / Secrets hold the three pieces together on one page (inline comments in the code, no annotation +). - 'What can run here' tip moved above the flow; section renamed 'Preparing for Deploy' with the 'you don't run deploy commands' point folded sparsely into the intro (standalone note removed); 'svc never changes' called out. - Flow diagram (below the tabs): build group now includes our libraries; git -> staging shown as develop-if-gitflow (dotted); deployment (no MR-to-main) -> docker image built + run on the fleet. - Revert inbound links to deploy.md. Verified in-browser: diagram renders with all nodes, tabs switch, section order correct; mkdocs build --strict clean. Signed-off-by: disqualifier <dev@disqualifier.me>
67 lines
1.5 KiB
YAML
67 lines
1.5 KiB
YAML
site_name: rethink development
|
|
site_description: Libraries, coding standards, and how to deploy on our network.
|
|
site_url: https://docs.rethinkstudios.io/
|
|
copyright: rethink development (handbook)
|
|
|
|
extra_css:
|
|
- stylesheets/extra.css
|
|
|
|
extra_javascript:
|
|
- javascripts/mermaid.min.js
|
|
- javascripts/mermaid-init.js
|
|
|
|
theme:
|
|
name: material
|
|
language: en
|
|
logo: assets/logo.svg
|
|
favicon: assets/logo.svg
|
|
palette:
|
|
scheme: slate
|
|
primary: custom
|
|
accent: custom
|
|
features:
|
|
- navigation.instant
|
|
- navigation.tracking
|
|
- navigation.top
|
|
- toc.follow
|
|
- search.suggest
|
|
- search.highlight
|
|
- content.code.copy
|
|
- content.code.annotate
|
|
icon:
|
|
repo: fontawesome/brands/git-alt
|
|
|
|
markdown_extensions:
|
|
- admonition
|
|
- attr_list
|
|
- md_in_html
|
|
- tables
|
|
- toc:
|
|
permalink: true
|
|
- pymdownx.details
|
|
- pymdownx.superfences:
|
|
custom_fences:
|
|
- name: mermaid
|
|
class: mermaid
|
|
format: !!python/name:pymdownx.superfences.fence_div_format
|
|
- pymdownx.tabbed:
|
|
alternate_style: true
|
|
- pymdownx.highlight:
|
|
anchor_linenums: true
|
|
- pymdownx.inlinehilite
|
|
- pymdownx.snippets
|
|
- pymdownx.emoji:
|
|
emoji_index: !!python/name:material.extensions.emoji.twemoji
|
|
emoji_generator: !!python/name:material.extensions.emoji.to_svg
|
|
|
|
plugins:
|
|
- search
|
|
|
|
nav:
|
|
- Home: index.md
|
|
- Libraries: libraries.md
|
|
- Standards: standards.md
|
|
- Workflow: workflow.md
|
|
- Virtual environments: environments.md
|
|
- Deploy: deploy.md
|