译文
译自西班牙语原文，以原文为规范文本。 状态：草稿，待人工审校。如有歧义，以西班牙语原文为准。
参与这些方法论¶
你无需隶属于 Kasai Labs，即可改进 ASILO、MILPA 和 SCAFFOLD。我们接受在行文、虚构示例或经脱敏处理的真实案例、翻译、无障碍、来源以及要求评估方面的贡献。你也可以不写代码，只指出一处矛盾或提出方法论上的变更。
这些页面是贡献政策、治理和行为准则的共同来源。它们在 Git 中维护，并通过 MkDocs 展示。仓库的入口文件链接到这些政策；变更提案与其余文档使用相同的审查流程。
以任何语言参与¶
你可以用自己偏好的语言提交 Issue、发表评论和提出变更。参与无需使用西班牙语或英语。仓库维护者可能使用机器翻译来理解你的贡献，并会在这样做时告知你；如果某句话可以有两种理解，他们会先询问再做决定。规范性文本以西班牙语维护，因此被接受的提案之后会用西班牙语撰写，并在可能时与你一起审阅。
选择一种贡献¶
| 你想要…… | 第一步 |
|---|---|
| 修正笔误或链接 | 提交包含该修正及其检查的 PR（变更请求，pull request）。 |
| 澄清一处说明或译文 | 找出作为参照的西班牙语文本，并说明差异。 |
| 添加来源或示例 | 说明它支持哪项论断；使用虚构数据和可核实的引用。 |
| 提供经脱敏处理的真实案例 | 取得相关人员或组织的书面同意，并对案例进行匿名化处理；在合并之前，由一位维护者审查匿名化处理。不要在 Issue 或 PR 中附上同意书。 |
| 修改某项要求或其范围 | 提交 Issue，写明 ID、版本、问题和预期影响。 |
| 审查一项提案 | 在其 Issue 或 PR 中评论，并给出论据和来源。 |
| 报告敏感问题 | 遵循报告流程。 |
fork 是仓库的一份副本，你可以在其中工作而无需原仓库的写入权限。分支汇集一次贡献的变更。**pull request（PR）**提议合并该分支，并保留其讨论与审查记录。Codeberg 在其 fork 与 PR 指南中记录了这一流程。
从想法到 PR¶
- 查看仓库，找到受影响的页面或要求。对于实质性变更，请提交一个 Issue，写明问题、范围和证据。小的修正可以直接以 PR 开始。
- 在你的 Codeberg 账户中创建 fork，并创建一个描述性的分支，例如
docs/milpa-provenance-example。每个分支只放一项具体的贡献。 - 编辑所需的文件。查看 Markdown 无需安装任何工具；要编译站点，请使用仓库自身的说明和依赖。这种参与不需要访问生态系统中的其他仓库或服务。
- 先用西班牙语撰写和审阅。译文应标明源页面和源版本，保留 ID、条件、数字和规范性效力，并记录待解决的差异。英语仅供参考；请使用编辑公理。
- 运行与该变更相应的、已有文档说明的检查。如果无法运行，请在 PR 中说明原因；不要把尚未完成的检查说成已通过。
- 从你的分支提交 PR。描述问题、受影响的文件和 ID、结果、证据、对版本的影响以及检查。如有 Issue 请链接，并声明相关的人工智能辅助情况。
- 回应审查意见。待意见解决，并记录了该类变更所要求的决定后，维护者进行合并。治理说明了谁审查、谁决定，以及如何重新考虑一项决定。
检查你的贡献¶
使用 Python 3.11 或更高版本，创建虚拟环境，并在克隆目录的根目录安装 requirements-docs.txt。激活该环境后，运行通用检查：
python scripts/check-all-docs.py
该命令检查链接、术语、规范完整性、图示来源和翻译；随后在其自身的临时文件夹中以 --strict 编译 MkDocs，并检查来源与站点中的敏感模式。哈希一致可检测变更，但不能证明语言上的等价。扫描器未发现问题，也不能证明不存在敏感数据。
对于视觉方面的变更，还要在桌面和移动端查看站点、文字说明、标签和 SVG（可缩放矢量图形）。记录环境、结果和待办事项。这既不是对实现软件的审计，也不是无障碍或安全方面的认证。
来源、署名与人工智能辅助¶
贡献者对自己提交的文本负责，即使使用了人工智能来撰写、翻译或调研。请说明工具协助了哪项任务，以及你核实了什么，例如：“人工智能用于初稿；来源与等价性已由贡献者核对”。该声明不能代替对来源的审查，也不会赋予智能体权威。请使用合成示例或已取得书面同意并经脱敏处理的真实案例，避免把敏感数据发送给外部工具。请确认人工智能提供商的条款允许你贡献其产出，并且不要上传你无权共享的第三方材料。如果商业、工作或个人利益与你的提案有关，请在 PR 中声明；声明并不妨碍你做出贡献。
请保留每项资源的署名、许可证和来源。只贡献你有权依据适用许可证分发的材料。除非另有明确说明，自有文本采用 CC BY-SA 4.0 许可；官方摘要说明了署名、修改以及按其条款共享改编作品的要求。另请参阅仓库中的 LICENSE 和 ASSETS.md，了解完整文本及资源的例外情形。PR 的审查规范的是其在本仓库中的合并；它不限制许可证所授予的复制、改编或维护 fork 的权利。
品牌资源和字体保留各自特定的条件。脚本、测试、模板、CSS 和 JavaScript 采用 Apache-2.0 许可证，因为 Creative Commons 建议为软件使用专门的许可证。REUSE.toml 规定每个路径的许可证，NOTICE 对此作了概括。贡献内容采用其所修改文件的许可证；不要求转让权利。
没有现成变更时如何开始¶
提交一个简短的 Issue，写明相对路径、段落或 ID，以及你无法解决的问题。请勿包含凭据、个人路径，或未经脱敏处理的真实档案和截图。一条具体的意见本身就有助于改进文档。公开讨论记录的是参与情况；其本身并不证明社区已批准或方法已被采用。