mirror of
https://github.com/spantaleev/matrix-docker-ansible-deploy.git
synced 2026-07-18 20:45:33 +03:00
github-actions[bot]
110 lines
4.1 KiB
Plaintext
110 lines
4.1 KiB
Plaintext
# SOME DESCRIPTIVE TITLE.
|
|
# Copyright (C) 2018-2026, Slavi Pantaleev, Aine Etke, MDAD community members
|
|
# This file is distributed under the same license as the matrix-docker-ansible-deploy package.
|
|
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
|
|
#
|
|
#, fuzzy
|
|
msgid ""
|
|
msgstr ""
|
|
"Project-Id-Version: matrix-docker-ansible-deploy \n"
|
|
"Report-Msgid-Bugs-To: \n"
|
|
"POT-Creation-Date: 2026-07-18 04:11+0000\n"
|
|
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
|
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
|
"Language-Team: LANGUAGE <LL@li.org>\n"
|
|
"MIME-Version: 1.0\n"
|
|
"Content-Type: text/plain; charset=UTF-8\n"
|
|
"Content-Transfer-Encoding: 8bit\n"
|
|
|
|
#: ../../../AGENTS.md:7
|
|
msgid "Guidance for AI agents"
|
|
msgstr ""
|
|
|
|
#: ../../../AGENTS.md:9
|
|
msgid "This file gives AI coding agents the minimum context for working on this repository. Human contributors may find it a useful summary too."
|
|
msgstr ""
|
|
|
|
#: ../../../AGENTS.md:11
|
|
msgid "What this is"
|
|
msgstr ""
|
|
|
|
#: ../../../AGENTS.md:13
|
|
msgid "An Ansible playbook that installs and manages a Matrix homeserver and dozens of related services, each running as a Docker container wrapped in a systemd service."
|
|
msgstr ""
|
|
|
|
#: ../../../AGENTS.md:15
|
|
msgid "Layout"
|
|
msgstr ""
|
|
|
|
#: ../../../AGENTS.md:17
|
|
msgid "`setup.yml`: the main playbook, listing all roles."
|
|
msgstr ""
|
|
|
|
#: ../../../AGENTS.md:18
|
|
msgid "`roles/custom/`: roles maintained in this repository."
|
|
msgstr ""
|
|
|
|
#: ../../../AGENTS.md:19
|
|
msgid "`roles/galaxy/`: external roles, downloaded according to `requirements.yml` via [agru](https://github.com/etkecc/agru) (preferred) or `ansible-galaxy`. Run `just roles` to install them (or `just update` to also pull the playbook itself). Editing these roles locally is fine while preparing or testing a fix, but the changes get wiped on the next roles update, so they must be synced back to the role's upstream repository, followed by a version pin update in `requirements.yml`."
|
|
msgstr ""
|
|
|
|
#: ../../../AGENTS.md:20
|
|
msgid "`group_vars/matrix_servers`: wires roles together (feeding one role's variables into another). Values a role can construct by itself belong in the role's `defaults/main.yml`, not here."
|
|
msgstr ""
|
|
|
|
#: ../../../AGENTS.md:21
|
|
msgid "`docs/`: user-facing documentation, one page per component."
|
|
msgstr ""
|
|
|
|
#: ../../../AGENTS.md:22
|
|
msgid "`i18n/`: translation infrastructure. Do not edit locale files by hand; they are managed by automation."
|
|
msgstr ""
|
|
|
|
#: ../../../AGENTS.md:23
|
|
msgid "`CHANGELOG.md`: user-facing announcements, newest first."
|
|
msgstr ""
|
|
|
|
#: ../../../AGENTS.md:25
|
|
msgid "Conventions"
|
|
msgstr ""
|
|
|
|
#: ../../../AGENTS.md:27
|
|
msgid "Follow the [style guide for playbook developers](docs/style-guide.md). In particular:"
|
|
msgstr ""
|
|
|
|
#: ../../../AGENTS.md:29
|
|
msgid "Variable prefixes match the role directory name."
|
|
msgstr ""
|
|
|
|
#: ../../../AGENTS.md:30
|
|
msgid "Playbook-extensible list variables use the `_auto` + `_custom` split; `_custom` is reserved for users."
|
|
msgstr ""
|
|
|
|
#: ../../../AGENTS.md:31
|
|
msgid "Renamed or removed variables get a validation entry, so stale user configuration produces an error instead of being silently ignored. Each role deprecates its own variables in its `validate_config.yml`; the `matrix_playbook_migration` role covers eliminated roles and very-early validation, and also gates breaking changes via `matrix_playbook_migration_expected_version` (see the style guide)."
|
|
msgstr ""
|
|
|
|
#: ../../../AGENTS.md:32
|
|
msgid "Every file carries SPDX license headers ([REUSE](https://reuse.software/) specification)."
|
|
msgstr ""
|
|
|
|
#: ../../../AGENTS.md:33
|
|
msgid "New components must be registered in `setup.yml`, `group_vars/matrix_servers`, `docs/README.md`, `README.md`, `docs/container-images.md`, and get a `CHANGELOG.md` entry."
|
|
msgstr ""
|
|
|
|
#: ../../../AGENTS.md:35
|
|
msgid "Other notes"
|
|
msgstr ""
|
|
|
|
#: ../../../AGENTS.md:37
|
|
msgid "Documentation examples use `example.com`, `@alice:example.com`, and the other placeholder values listed in the style guide."
|
|
msgstr ""
|
|
|
|
#: ../../../AGENTS.md:38
|
|
msgid "Write role tasks concurrency-safe: use `ansible.builtin.tempfile` for temporary files (removed in an `always` block), never fixed shared paths."
|
|
msgstr ""
|
|
|
|
#: ../../../AGENTS.md:39
|
|
msgid "One logical change per commit."
|
|
msgstr ""
|