forked from mirrors/jj
5aa6fa5974
In order for the governance working group to make progress establishing jj's governance structure, we need the approval of the jj community. Set up a temporary voting process to get that approval. Additionally, set up a governance dir for other governance-related documentation to sit in. Later, when we have a permanent governance structure and enough policy to let the community make changes without needing the governance working group, we can delete this document.
142 lines
4.5 KiB
YAML
142 lines
4.5 KiB
YAML
site_name: Jujutsu docs
|
|
site_dir: 'rendered-docs'
|
|
# Not having this (or viewing the site locally, or from any place other than the
|
|
# site_url) leads to version switching failing to preserve the current path.
|
|
site_url: !ENV [SITE_URL_FOR_MKDOCS, 'https://martinvonz.github.io/jj/']
|
|
theme:
|
|
name: 'material'
|
|
language: 'en'
|
|
features:
|
|
# - navigation.top
|
|
|
|
# Respect the user's default settings and add a toggle for manually choosing
|
|
# automatic/light/dark palette.
|
|
# taken from https://squidfunk.github.io/mkdocs-material/setup/changing-the-colors/#system-preference
|
|
palette:
|
|
- media: "(prefers-color-scheme)"
|
|
toggle:
|
|
icon: material/brightness-auto
|
|
name: Switch to system preference
|
|
- media: "(prefers-color-scheme: light)"
|
|
scheme: default
|
|
toggle:
|
|
icon: material/brightness-7
|
|
name: Switch to light mode
|
|
- media: "(prefers-color-scheme: dark)"
|
|
scheme: slate
|
|
toggle:
|
|
icon: material/brightness-4
|
|
name: Switch to dark mode
|
|
|
|
extra:
|
|
version:
|
|
provider: mike
|
|
alias: true
|
|
|
|
validation:
|
|
anchors: warn
|
|
|
|
# IMPORTANT: any changes to plugins have to be duplicated in
|
|
# `mkdocs-offline.yml`. See that file for more details.
|
|
plugins:
|
|
- mike:
|
|
# Should help search engines point to latest docs
|
|
# instead of (often obsolete) v?.??.? docs.
|
|
# TODO: Arguably, this could be `prerelease` when building prerelease docs.
|
|
canonical_version: latest
|
|
- include-markdown # For the CLI reference
|
|
- search
|
|
- redirects:
|
|
redirect_maps:
|
|
|
|
# Not all of these may be necessary, especially since the material
|
|
# theme substitutes for some of them
|
|
markdown_extensions:
|
|
- toc:
|
|
permalink: true
|
|
- extra
|
|
- sane_lists
|
|
- admonition
|
|
- codehilite:
|
|
guess_lang: false
|
|
# Allows list items with several paragraphs to be indented two spaces instead
|
|
# of four (like GitHub markdown)
|
|
- mdx_truly_sane_lists:
|
|
# No, thanks, we'd like only somewhat sane lists :)
|
|
# With `truly_sane: true`, together with breakless lists, it often splits
|
|
# a single list in two.
|
|
truly_sane: false
|
|
# Fixes weird concatenation of list items that happens sometimes when
|
|
# there is not a paragraph break between them and one of them has
|
|
# multiple paragraphs.
|
|
- mdx_breakless_lists
|
|
- pymdownx.tabbed:
|
|
alternate_style: true
|
|
- pymdownx.superfences:
|
|
custom_fences:
|
|
- name: mermaid
|
|
class: mermaid
|
|
format: !!python/name:pymdownx.superfences.fence_code_format
|
|
- pymdownx.details
|
|
- pymdownx.snippets
|
|
- pymdownx.emoji:
|
|
emoji_index: !!python/name:material.extensions.emoji.twemoji
|
|
emoji_generator: !!python/name:material.extensions.emoji.to_svg
|
|
|
|
# This lists all the files that become part of the documentation
|
|
nav:
|
|
- 'Home': 'index.md'
|
|
|
|
- 'Getting started':
|
|
- 'Installation and Setup': 'install-and-setup.md'
|
|
- 'Tutorial and Birds-Eye View': 'tutorial.md'
|
|
- 'Working with GitHub': 'github.md'
|
|
- 'Working on Windows': 'windows.md'
|
|
|
|
- FAQ: 'FAQ.md'
|
|
|
|
- "CLI Reference": 'cli-reference.md'
|
|
|
|
- Testimonials: 'testimonials.md'
|
|
|
|
- "Community-built tools": 'community_tools.md'
|
|
|
|
- Concepts:
|
|
- 'Working Copy': 'working-copy.md'
|
|
- 'Bookmarks': 'bookmarks.md'
|
|
- 'Conflicts': 'conflicts.md'
|
|
- 'Operation Log': 'operation-log.md'
|
|
- 'Glossary': 'glossary.md'
|
|
|
|
- 'Configuration':
|
|
- 'Settings': 'config.md'
|
|
- 'Fileset language': 'filesets.md'
|
|
- 'Revset language': 'revsets.md'
|
|
- 'Templating language': 'templates.md'
|
|
|
|
- 'Comparisons':
|
|
- 'Git comparison': 'git-comparison.md'
|
|
- 'Git compatibility': 'git-compatibility.md'
|
|
- 'Sapling': 'sapling-comparison.md'
|
|
- 'Other related work': 'related-work.md'
|
|
|
|
- 'Technical details':
|
|
- 'Architecture': 'technical/architecture.md'
|
|
- 'Concurrency': 'technical/concurrency.md'
|
|
- 'Conflicts': 'technical/conflicts.md'
|
|
|
|
- Contributing:
|
|
- 'Guidelines and "How to...?"': 'contributing.md'
|
|
- 'Code of conduct': 'code-of-conduct.md'
|
|
- 'Design Docs': 'design_docs.md'
|
|
- 'Design Doc Blueprint': 'design_doc_blueprint.md'
|
|
- 'Temporary Voting for Governance': 'governance/temporary-voting.md'
|
|
|
|
- 'Design docs':
|
|
- 'Roadmap': "roadmap.md"
|
|
- 'git-submodules': 'design/git-submodules.md'
|
|
- 'git-submodule-storage': 'design/git-submodule-storage.md'
|
|
- 'JJ run': 'design/run.md'
|
|
- 'Sparse Patterns v2': 'design/sparse-v2.md'
|
|
- 'Tracking branches': 'design/tracking-branches.md'
|
|
- 'Copy tracking and tracing': 'design/copy-tracking.md'
|