docs: add Portuguese (pt-BR) translation of CONTRIBUTING.md#207
docs: add Portuguese (pt-BR) translation of CONTRIBUTING.md#207nikolasdehor wants to merge 3 commits intoSynkraAI:mainfrom
Conversation
|
@nikolasdehor is attempting to deploy a commit to the Pedro Valério Lopez's projects Team on Vercel. A member of the Team first needs to authorize it. |
WalkthroughThe Portuguese contributor guide was updated with comprehensive rebranding from AIOS to AIOX terminology, Portuguese language corrections and standardization, structural improvements to headings and section anchors, and a new section detailing workflows for the Pro submodule alongside open-source contributions. Changes
Estimated code review effort🎯 2 (Simple) | ⏱️ ~10 minutes Possibly related PRs
Suggested labels
Suggested reviewers
🚥 Pre-merge checks | ✅ 4 | ❌ 1❌ Failed checks (1 warning)
✅ Passed checks (4 passed)
✏️ Tip: You can configure your own custom pre-merge checks in the settings. ✨ Finishing Touches🧪 Generate unit tests (beta)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
There was a problem hiding this comment.
Actionable comments posted: 4
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.
Inline comments:
In `@CONTRIBUTING-PT.md`:
- Around line 114-118: Add the missing language specifier "text" to the five
fenced code blocks that currently use plain ``` fences: the commit format
template block containing "<tipo>: <descrição>", the agent file path block
".aios-core/development/agents/seu-agent.md", the task file path block
".aios-core/development/tasks/sua-task.md", the squad directory tree starting
with "seu-squad/" and the file organization tree starting with ".aios-core/";
update each opening fence from ``` to ```text so the blocks like "<tipo>:
<descrição>", ".aios-core/development/agents/seu-agent.md",
".aios-core/development/tasks/sua-task.md", "seu-squad/ ├── manifest.yaml", and
".aios-core/ ├── development/" are rendered with the suggested language tag.
- Around line 63-65: Add a blank line between the bold label "**Convenções de
Nomenclatura de Branches:**" and the start of the table (the row beginning with
"| Prefixo | Uso |") so the table is separated by an empty line from the
preceding paragraph/header to satisfy MD058.
- Around line 7-21: Add the missing "## Recursos Adicionais" entry to the
document's table of contents so it reflects the actual headings; update the ToC
list (the block starting with "## Sumário") to include a "- [Recursos
Adicionais](`#recursos-adicionais`)" item to match the existing "## Recursos
Adicionais" section in the file.
- Around line 321-323: CONTRIBUTING-PT.md contains broken internal links: update
or remove references to templates/squad/, COMMUNITY.md,
docs/architecture/adr/adr-pro-001-repository-strategy.md, and ROADMAP.md; either
create the missing files/directories with the referenced content
(templates/squad/, COMMUNITY.md, the ADR file, ROADMAP.md) or change the links
in CONTRIBUTING-PT.md to point to existing resources (e.g., correct templates
path, existing community docs, actual ADR file location or an alternative
ROADMAP), and then run a repo-wide link check/search to ensure no other
references to these exact names remain.
CONTRIBUTING-PT.md
Outdated
| - [Guia de Squads](docs/guides/squads-guide.md) - Documentação completa | ||
| - [Template de Squad](templates/squad/) - Comece a partir de um template funcional | ||
| - [Discussões sobre Squads](https://github.com/SynkraAI/aios-core/discussions/categories/ideas) - Compartilhe ideias |
There was a problem hiding this comment.
🧩 Analysis chain
🏁 Script executed:
#!/bin/bash
# Verify that all internal relative links in CONTRIBUTING-PT.md point to existing files/directories.
echo "=== Checking internal links referenced in CONTRIBUTING-PT.md ==="
paths=(
"docs/guides/squads-guide.md"
"templates/squad"
"COMMUNITY.md"
"docs/architecture/adr/adr-pro-001-repository-strategy.md"
"docs/guides/workflows/pro-developer-workflow.md"
"docs/architecture"
"ROADMAP.md"
"CONTRIBUTING.md"
)
for p in "${paths[@]}"; do
if [ -e "$p" ]; then
echo " ✅ EXISTS: $p"
else
echo " ❌ MISSING: $p"
fi
doneRepository: SynkraAI/aios-core
Length of output: 433
Fix broken internal documentation links.
Several referenced files and directories do not exist in the repository:
- Line 322:
templates/squad/— directory missing - Lines 529, 574:
COMMUNITY.md— file missing - Line 535:
docs/architecture/adr/adr-pro-001-repository-strategy.md— file missing - Line 577:
ROADMAP.md— file missing
Either create these files or update the links to point to existing resources.
🧰 Tools
🪛 LanguageTool
[typographical] ~321-~321: Símbolo sem par: “[” aparentemente está ausente
Context: ...Recursos sobre Squads - Guia de Squads - Document...
(UNPAIRED_BRACKETS)
[locale-violation] ~322-~322: “Template” é um estrangeirismo. É preferível dizer “modelo”.
Context: ...ds-guide.md) - Documentação completa - Template de Squad - Comece a ...
(PT_BARBARISMS_REPLACE_TEMPLATE)
[typographical] ~322-~322: Símbolo sem par: “[” aparentemente está ausente
Context: ...cumentação completa - Template de Squad - Comece a partir de ...
(UNPAIRED_BRACKETS)
[locale-violation] ~322-~322: “template” é um estrangeirismo. É preferível dizer “modelo”.
Context: ...mplates/squad/) - Comece a partir de um template funcional - [Discussões sobre Squads](h...
(PT_BARBARISMS_REPLACE_TEMPLATE)
[typographical] ~323-~323: Símbolo sem par: “[” aparentemente está ausente
Context: ...ate funcional - [Discussões sobre Squads](https://github.com/SynkraAI/aios-core/d...
(UNPAIRED_BRACKETS)
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.
In `@CONTRIBUTING-PT.md` around lines 321 - 323, CONTRIBUTING-PT.md contains
broken internal links: update or remove references to templates/squad/,
COMMUNITY.md, docs/architecture/adr/adr-pro-001-repository-strategy.md, and
ROADMAP.md; either create the missing files/directories with the referenced
content (templates/squad/, COMMUNITY.md, the ADR file, ROADMAP.md) or change the
links in CONTRIBUTING-PT.md to point to existing resources (e.g., correct
templates path, existing community docs, actual ADR file location or an
alternative ROADMAP), and then run a repo-wide link check/search to ensure no
other references to these exact names remain.
There was a problem hiding this comment.
Pull request overview
This PR adds a complete Brazilian Portuguese translation of the contributing guide. The translation creates CONTRIBUTING-PT.md in the root directory to match the existing link in CONTRIBUTING.md line 3. The translation uses natural Brazilian Portuguese while appropriately keeping technical terms in English (fork, branch, commit, pull request, etc.). Proper Portuguese accents and diacritics are used throughout, and all markdown formatting, code blocks, and links are preserved.
Changes:
- Added complete Brazilian Portuguese translation as
CONTRIBUTING-PT.md(581 lines) - Includes reverse link to English version at the top
- Translates all sections including the "Working with Pro" section that was added to the English version
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
CONTRIBUTING-PT.md
Outdated
| # Contribuindo com o Synkra AIOS | ||
|
|
||
| > **[English Version](CONTRIBUTING.md)** | ||
|
|
||
| Bem-vindo ao AIOS! Obrigado pelo seu interesse em contribuir. Este guia vai ajudá-lo a entender nosso fluxo de desenvolvimento, processo de contribuição e como submeter suas alterações. | ||
|
|
||
| ## Sumário | ||
|
|
||
| - [Início Rápido](#início-rápido) | ||
| - [Tipos de Contribuição](#tipos-de-contribuição) | ||
| - [Fluxo de Desenvolvimento](#fluxo-de-desenvolvimento) | ||
| - [Contribuindo com Agents](#contribuindo-com-agents) | ||
| - [Contribuindo com Tasks](#contribuindo-com-tasks) | ||
| - [Contribuindo com Squads](#contribuindo-com-squads) | ||
| - [Processo de Code Review](#processo-de-code-review) | ||
| - [Sistema de Validação](#sistema-de-validação) | ||
| - [Padrões de Código](#padrões-de-código) | ||
| - [Requisitos de Testes](#requisitos-de-testes) | ||
| - [Perguntas Frequentes](#perguntas-frequentes) | ||
| - [Obtendo Ajuda](#obtendo-ajuda) | ||
| - [Trabalhando com o Pro](#trabalhando-com-o-pro) | ||
|
|
||
| --- | ||
|
|
||
| ## Início Rápido | ||
|
|
||
| ### 1. Fork e Clone | ||
|
|
||
| ```bash | ||
| # Faça o fork pela interface do GitHub, depois clone seu fork | ||
| git clone https://github.com/SEU_USUARIO/aios-core.git | ||
| cd aios-core | ||
|
|
||
| # Adicione o remote upstream | ||
| git remote add upstream https://github.com/SynkraAI/aios-core.git | ||
| ``` | ||
|
|
||
| ### 2. Configure o Ambiente de Desenvolvimento | ||
|
|
||
| **Pré-requisitos:** | ||
|
|
||
| - Node.js >= 20.0.0 | ||
| - npm |
There was a problem hiding this comment.
There's a documentation organization issue: this PR creates CONTRIBUTING-PT.md in the root directory, but there's already an existing Portuguese contributing file at docs/pt/contributing.md (542 lines). The README.md (line 725) links to docs/pt/contributing.md as the Portuguese contributing guide. This creates duplicate documentation that could lead to confusion and maintenance issues.
The new file has improvements over the existing one (proper Portuguese accents/diacritics and includes the "Working with Pro" section), but having two Portuguese contributing files in different locations is problematic.
Consider one of these approaches:
- Remove or update
docs/pt/contributing.mdto redirect to this file - Update README.md line 725 to point to
CONTRIBUTING-PT.mdinstead ofdocs/pt/contributing.md - Choose one canonical location and deprecate the other
This needs to be resolved to avoid documentation fragmentation.
| # Contribuindo com o Synkra AIOS | |
| > **[English Version](CONTRIBUTING.md)** | |
| Bem-vindo ao AIOS! Obrigado pelo seu interesse em contribuir. Este guia vai ajudá-lo a entender nosso fluxo de desenvolvimento, processo de contribuição e como submeter suas alterações. | |
| ## Sumário | |
| - [Início Rápido](#início-rápido) | |
| - [Tipos de Contribuição](#tipos-de-contribuição) | |
| - [Fluxo de Desenvolvimento](#fluxo-de-desenvolvimento) | |
| - [Contribuindo com Agents](#contribuindo-com-agents) | |
| - [Contribuindo com Tasks](#contribuindo-com-tasks) | |
| - [Contribuindo com Squads](#contribuindo-com-squads) | |
| - [Processo de Code Review](#processo-de-code-review) | |
| - [Sistema de Validação](#sistema-de-validação) | |
| - [Padrões de Código](#padrões-de-código) | |
| - [Requisitos de Testes](#requisitos-de-testes) | |
| - [Perguntas Frequentes](#perguntas-frequentes) | |
| - [Obtendo Ajuda](#obtendo-ajuda) | |
| - [Trabalhando com o Pro](#trabalhando-com-o-pro) | |
| --- | |
| ## Início Rápido | |
| ### 1. Fork e Clone | |
| ```bash | |
| # Faça o fork pela interface do GitHub, depois clone seu fork | |
| git clone https://github.com/SEU_USUARIO/aios-core.git | |
| cd aios-core | |
| # Adicione o remote upstream | |
| git remote add upstream https://github.com/SynkraAI/aios-core.git | |
| ``` | |
| ### 2. Configure o Ambiente de Desenvolvimento | |
| **Pré-requisitos:** | |
| - Node.js >= 20.0.0 | |
| - npm | |
| # Contribuindo com o Synkra AIOS (Português) | |
| > **[English Version](CONTRIBUTING.md)** | |
| Este repositório já possui um guia de contribuição em português mantido como fonte canônica em: | |
| **[`docs/pt/contributing.md`](docs/pt/contributing.md)** | |
| Para evitar duplicação e problemas de manutenção, todo o conteúdo detalhado do guia em português está localizado apenas nesse arquivo dentro de `docs/pt/`. | |
| Se você deseja contribuir com o Synkra AIOS em português, acesse diretamente: | |
| - Guia oficial em português: [`docs/pt/contributing.md`](docs/pt/contributing.md) | |
| - Versão em inglês: [`CONTRIBUTING.md`](CONTRIBUTING.md) | |
| Caso você tenha chegado aqui por um link antigo ou pesquisa no GitHub, utilize os links acima para acessar a documentação mais atualizada. |
nikolasdehor
force-pushed
the
docs/contributing-pt-br
branch
from
01be3b1 to
ca3b3f9
Compare
Maintainer ReviewThe Portuguese translation is welcome — Issue: CodeRabbit flagged 4 actionable items (formatting, code block language specs, etc.). Please address those. Important: Make sure the file path matches what's referenced in If you place the file at |
- Adicionado '## Recursos Adicionais' ao sumário (ToC) - Adicionada linha em branco antes da tabela de branches (MD058) - Adicionado especificador 'text' em 5 blocos de código sem linguagem - Corrigidos links quebrados: removido link para COMMUNITY.md inexistente, removido link para templates/squad/ inexistente, removido link para ADR-PRO-001 inexistente
nikolasdehor
requested review from
Pedrovaleriolopez and
oalanicolas
as code owners
- Removido CONTRIBUTING-PT.md (path antigo) - Atualizado docs/pt/contributing.md com rebrand completo - AIOS → AIOX, .aios-core → .aiox-core, aios-core → aiox-core - Atualizado link relativo para English Version - Aplicadas 4 correções do CodeRabbit (ToC, MD058, code blocks, links)
There was a problem hiding this comment.
Actionable comments posted: 10
Caution
Some comments are outside the diff and can’t be posted inline due to platform limitations.
⚠️ Outside diff range comments (1)
docs/pt/contributing.md (1)
1-582:⚠️ Potential issue | 🔴 CriticalReplace all instances of incorrect product and repository names
The file contains systematic branding and naming errors stemming from an incorrect find-replace during translation:
- AIOX (4 instances): Should be AIOS — product name branding
- aiox-core (14 instances): Should be aios-core — repository name
- .aiox-core (3 instances): Should be .aios-core — directory path prefix
These errors appear on lines 1, 5, 32, 33, 36, 149, 223, 324, 429, 528, 529, 530, 536, 543, 544, 554, 560, and 582. Correct all instances to maintain consistency with the actual project naming conventions.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed. In `@docs/pt/contributing.md` around lines 1 - 582, The document contains systematic incorrect branding from a faulty find/replace: replace all occurrences of the strings "AIOX" → "AIOS", "aiox-core" → "aios-core", and ".aiox-core" → ".aios-core" throughout the file (including header/title, repo links, code blocks, directory examples and textual references such as the top title, links like ../../CONTRIBUTING.md, `.aiox-core/development/...` examples, and any table or inline mentions); ensure you update every instance (the 4 AIOX, 14 aiox-core, and 3 .aiox-core occurrences noted) and verify consistency in code examples, YAML/markdown snippets and any cross-references so the product and repository names match the project's canonical "AIOS" and "aios-core"/".aios-core".
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.
Inline comments:
In `@docs/pt/contributing.md`:
- Around line 543-544: The Pro section uses the wrong repository name
"aiox-core" in the git commands and references; replace every occurrence of the
string "aiox-core" (e.g., the git clone and cd lines and other Pro-section
mentions) with the correct repository name "aios-core", and update any
corresponding URLs or links to match "https://github.com/SynkraAI/aios-core" to
ensure the commands and references are accurate.
- Line 5: Search the document for every occurrence of the string "AIOX" and
replace it with the correct project name "AIOS" (preserve casing and surrounding
punctuation), leaving existing correct "AIOS" instances untouched; ensure
replacements cover headings, body text, links, and any variations with
punctuation or parentheses so no "AIOX" remains (also verify the previously
correct "AIOS" occurrences are unchanged).
- Line 223: Update the incorrect directory path string
".aiox-core/development/tasks/sua-task.md" in docs/pt/contributing.md to the
correct ".aios-core/development/tasks/sua-task.md" so links/reference text point
to the actual repository directory; search for the exact token ".aiox-core" in
that file and replace it with ".aios-core" (verify other occurrences in the same
document).
- Line 149: Update the incorrect repository path string
".aiox-core/development/agents/seu-agent.md" to the correct
".aios-core/development/agents/seu-agent.md" in the docs/pt/contributing.md file
so links and references point to the actual directory; search for the
".aiox-core" token and replace it with ".aios-core" wherever it appears.
- Line 1: Replace the incorrect project name "AIOX" with the correct "AIOS"
throughout the Portuguese contributing doc; specifically update the header
string "Contribuindo com o Synkra AIOX" and any other occurrences of "Synkra
AIOX" in docs/pt/contributing.md to "Synkra AIOS" so it matches the English
source and repository naming.
- Around line 428-441: Add a language specifier to the fenced code block that
contains the directory tree (the lines starting with ``` and the listing
beginning ".aiox-core/") so the block renders as plaintext; update the opening
fence to use ```text (or ```plaintext) while leaving the directory lines and
closing ``` unchanged.
- Around line 528-531: The repository name is incorrect in the three GitHub URLs
(the strings containing "https://github.com/SynkraAI/aiox-core") — update each
occurrence to use "aios-core" instead of "aiox-core" (e.g., the links for "Abra
uma issue", "Inicie uma discussão", and "Discussões") so the URLs point to
https://github.com/SynkraAI/aios-core.
- Line 324: The GitHub discussion link text "Discussões sobre Squads" contains a
typo in the repository slug; update the URL by replacing "aiox-core" with the
correct "aios-core" so the link becomes
https://github.com/SynkraAI/aios-core/discussions/categories/ideas, ensuring the
visible link text remains unchanged.
- Line 429: Replace the incorrect directory name string ".aiox-core/" with the
correct repository directory ".aios-core/" in the docs entry; locate the line
that currently contains ".aiox-core/" (in the contributing.md content block) and
update that token to ".aios-core/" so documentation matches the actual
repository layout.
- Around line 32-36: The git commands in the contributing docs use the wrong
repository name "aiox-core"; update every occurrence of "aiox-core" to the
correct "aios-core" in docs/pt/contributing.md (the git clone and git remote add
upstream lines) so the example commands use git clone
https://github.com/SEU_USUARIO/aios-core.git and git remote add upstream
https://github.com/SynkraAI/aios-core.git.
---
Outside diff comments:
In `@docs/pt/contributing.md`:
- Around line 1-582: The document contains systematic incorrect branding from a
faulty find/replace: replace all occurrences of the strings "AIOX" → "AIOS",
"aiox-core" → "aios-core", and ".aiox-core" → ".aios-core" throughout the file
(including header/title, repo links, code blocks, directory examples and textual
references such as the top title, links like ../../CONTRIBUTING.md,
`.aiox-core/development/...` examples, and any table or inline mentions); ensure
you update every instance (the 4 AIOX, 14 aiox-core, and 3 .aiox-core
occurrences noted) and verify consistency in code examples, YAML/markdown
snippets and any cross-references so the product and repository names match the
project's canonical "AIOS" and "aios-core"/".aios-core".
ℹ️ Review info
⚙️ Run configuration
Configuration used: Path: .coderabbit.yaml
Review profile: CHILL
Plan: Pro
Run ID: 5a8c7683-c7c2-401b-8573-3d2644c8171c
📒 Files selected for processing (1)
docs/pt/contributing.md
| @@ -1,53 +1,55 @@ | |||
| # Contribuindo para o Synkra AIOS | |||
| # Contribuindo com o Synkra AIOX | |||
There was a problem hiding this comment.
Incorrect project name: Should be "AIOS" not "AIOX"
The project name is "Synkra AIOS", not "AIOX". This appears throughout the file and must be corrected to match the English source and the actual repository naming.
🔧 Proposed fix
-# Contribuindo com o Synkra AIOX
+# Contribuindo com o Synkra AIOS🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.
In `@docs/pt/contributing.md` at line 1, Replace the incorrect project name "AIOX"
with the correct "AIOS" throughout the Portuguese contributing doc; specifically
update the header string "Contribuindo com o Synkra AIOX" and any other
occurrences of "Synkra AIOX" in docs/pt/contributing.md to "Synkra AIOS" so it
matches the English source and repository naming.
| > **[English Version](../../CONTRIBUTING.md)** | ||
|
|
||
| Bem-vindo ao AIOS! Obrigado pelo seu interesse em contribuir. Este guia vai ajuda-lo a entender nosso fluxo de trabalho, processo de contribuicao e como submeter suas alteracoes. | ||
| Bem-vindo ao AIOX! Obrigado pelo seu interesse em contribuir. Este guia vai ajudá-lo a entender nosso fluxo de desenvolvimento, processo de contribuição e como submeter suas alterações. |
There was a problem hiding this comment.
Replace all "AIOX" references with "AIOS" throughout the document
The document inconsistently uses "AIOX" in most places but correctly uses "AIOS" on lines 348 and 387. The correct project name is "AIOS" as shown in the English source file.
🔧 Proposed fixes for each occurrence
-Bem-vindo ao AIOX! Obrigado pelo seu interesse em contribuir.
+Bem-vindo ao AIOS! Obrigado pelo seu interesse em contribuir.-O AIOX usa um modelo Open Core com um git submodule privado `pro/`.
+O AIOS usa um modelo Open Core com um git submodule privado `pro/`.-**Obrigado por contribuir com o Synkra AIOX!**
+**Obrigado por contribuir com o Synkra AIOS!**Also applies to: 536-536, 582-582
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.
In `@docs/pt/contributing.md` at line 5, Search the document for every occurrence
of the string "AIOX" and replace it with the correct project name "AIOS"
(preserve casing and surrounding punctuation), leaving existing correct "AIOS"
instances untouched; ensure replacements cover headings, body text, links, and
any variations with punctuation or parentheses so no "AIOX" remains (also verify
the previously correct "AIOS" occurrences are unchanged).
| git clone https://github.com/SEU_USUARIO/aiox-core.git | ||
| cd aiox-core | ||
|
|
||
| # Adicione o remote upstream | ||
| git remote add upstream https://github.com/SynkraAI/aios-core.git | ||
| git remote add upstream https://github.com/SynkraAI/aiox-core.git |
There was a problem hiding this comment.
Incorrect repository name in git commands: Should be "aios-core" not "aiox-core"
The repository name is aios-core, not aiox-core. These git commands will fail because the repository URL is incorrect.
🔧 Proposed fix
# Faça o fork pela interface do GitHub, depois clone seu fork
-git clone https://github.com/SEU_USUARIO/aiox-core.git
-cd aiox-core
+git clone https://github.com/SEU_USUARIO/aios-core.git
+cd aios-core
# Adicione o remote upstream
-git remote add upstream https://github.com/SynkraAI/aiox-core.git
+git remote add upstream https://github.com/SynkraAI/aios-core.git📝 Committable suggestion
‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.
| git clone https://github.com/SEU_USUARIO/aiox-core.git | |
| cd aiox-core | |
| # Adicione o remote upstream | |
| git remote add upstream https://github.com/SynkraAI/aios-core.git | |
| git remote add upstream https://github.com/SynkraAI/aiox-core.git | |
| git clone https://github.com/SEU_USUARIO/aios-core.git | |
| cd aios-core | |
| # Adicione o remote upstream | |
| git remote add upstream https://github.com/SynkraAI/aios-core.git |
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.
In `@docs/pt/contributing.md` around lines 32 - 36, The git commands in the
contributing docs use the wrong repository name "aiox-core"; update every
occurrence of "aiox-core" to the correct "aios-core" in docs/pt/contributing.md
(the git clone and git remote add upstream lines) so the example commands use
git clone https://github.com/SEU_USUARIO/aios-core.git and git remote add
upstream https://github.com/SynkraAI/aios-core.git.
| ``` | ||
| .aios-core/development/agents/seu-agent.md | ||
| ```text | ||
| .aiox-core/development/agents/seu-agent.md |
There was a problem hiding this comment.
Incorrect directory path: Should be ".aios-core" not ".aiox-core"
The actual directory in the repository is .aios-core, not .aiox-core. This incorrect path will direct contributors to a location that doesn't exist.
🔧 Proposed fix
-.aiox-core/development/agents/seu-agent.md
+.aios-core/development/agents/seu-agent.md📝 Committable suggestion
‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.
| .aiox-core/development/agents/seu-agent.md | |
| .aios-core/development/agents/seu-agent.md |
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.
In `@docs/pt/contributing.md` at line 149, Update the incorrect repository path
string ".aiox-core/development/agents/seu-agent.md" to the correct
".aios-core/development/agents/seu-agent.md" in the docs/pt/contributing.md file
so links and references point to the actual directory; search for the
".aiox-core" token and replace it with ".aios-core" wherever it appears.
| ``` | ||
| .aios-core/development/tasks/sua-task.md | ||
| ```text | ||
| .aiox-core/development/tasks/sua-task.md |
There was a problem hiding this comment.
Incorrect directory path: Should be ".aios-core" not ".aiox-core"
The actual directory in the repository is .aios-core, not .aiox-core. This incorrect path will direct contributors to a location that doesn't exist.
🔧 Proposed fix
-.aiox-core/development/tasks/sua-task.md
+.aios-core/development/tasks/sua-task.md📝 Committable suggestion
‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.
| .aiox-core/development/tasks/sua-task.md | |
| .aios-core/development/tasks/sua-task.md |
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.
In `@docs/pt/contributing.md` at line 223, Update the incorrect directory path
string ".aiox-core/development/tasks/sua-task.md" in docs/pt/contributing.md to
the correct ".aios-core/development/tasks/sua-task.md" so links/reference text
point to the actual repository directory; search for the exact token
".aiox-core" in that file and replace it with ".aios-core" (verify other
occurrences in the same document).
| - [Template de Squad](templates/squad/) - Comece de um template funcional | ||
| - [Discussoes de Squads](https://github.com/SynkraAI/aios-core/discussions/categories/ideas) - Compartilhe ideias | ||
| - [Guia de Squads](docs/guides/squads-guide.md) - Documentação completa | ||
| - [Discussões sobre Squads](https://github.com/SynkraAI/aiox-core/discussions/categories/ideas) - Compartilhe ideias |
There was a problem hiding this comment.
Incorrect repository name in GitHub URL: Should be "aios-core" not "aiox-core"
The GitHub discussion link uses aiox-core but the repository is aios-core.
🔧 Proposed fix
-- [Discussões sobre Squads](https://github.com/SynkraAI/aiox-core/discussions/categories/ideas) - Compartilhe ideias
+- [Discussões sobre Squads](https://github.com/SynkraAI/aios-core/discussions/categories/ideas) - Compartilhe ideias📝 Committable suggestion
‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.
| - [Discussões sobre Squads](https://github.com/SynkraAI/aiox-core/discussions/categories/ideas) - Compartilhe ideias | |
| - [Discussões sobre Squads](https://github.com/SynkraAI/aios-core/discussions/categories/ideas) - Compartilhe ideias |
🧰 Tools
🪛 LanguageTool
[typographical] ~324-~324: Símbolo sem par: “[” aparentemente está ausente
Context: ...ação completa - [Discussões sobre Squads](https://github.com/SynkraAI/aiox-core/d...
(UNPAIRED_BRACKETS)
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.
In `@docs/pt/contributing.md` at line 324, The GitHub discussion link text
"Discussões sobre Squads" contains a typo in the repository slug; update the URL
by replacing "aiox-core" with the correct "aios-core" so the link becomes
https://github.com/SynkraAI/aios-core/discussions/categories/ideas, ensuring the
visible link text remains unchanged.
| ``` | ||
| .aios-core/ | ||
| .aiox-core/ | ||
| ├── development/ | ||
| │ ├── agents/ # Definicoes de agents | ||
| │ ├── agents/ # Definições de agents | ||
| │ ├── tasks/ # Workflows de tasks | ||
| │ └── workflows/ # Workflows multi-etapas | ||
| ├── core/ # Utilitarios core | ||
| │ └── workflows/ # Workflows multi-step | ||
| ├── core/ # Utilitários principais | ||
| └── product/ | ||
| └── templates/ # Templates de documentos | ||
|
|
||
| docs/ | ||
| ├── guides/ # Guias do usuario | ||
| ├── guides/ # Guias de usuário | ||
| └── architecture/ # Arquitetura do sistema | ||
| ``` |
There was a problem hiding this comment.
Add language specifier to code block
The code block showing file organization is missing a language specifier. Using text or plaintext would improve rendering.
📝 Proposed fix
-```
+```text
.aios-core/
├── development/🧰 Tools
🪛 markdownlint-cli2 (0.21.0)
[warning] 428-428: Fenced code blocks should have a language specified
(MD040, fenced-code-language)
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.
In `@docs/pt/contributing.md` around lines 428 - 441, Add a language specifier to
the fenced code block that contains the directory tree (the lines starting with
``` and the listing beginning ".aiox-core/") so the block renders as plaintext;
update the opening fence to use ```text (or ```plaintext) while leaving the
directory lines and closing ``` unchanged.
|
|
||
| ``` | ||
| .aios-core/ | ||
| .aiox-core/ |
There was a problem hiding this comment.
Incorrect directory path: Should be ".aios-core" not ".aiox-core"
The file organization section shows .aiox-core/ but the actual directory in the repository is .aios-core/. This incorrect path will mislead contributors.
🔧 Proposed fix
-.aiox-core/
+.aios-core/
├── development/
│ ├── agents/ # Definições de agents📝 Committable suggestion
‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.
| .aiox-core/ | |
| .aios-core/ | |
| ├── development/ | |
| │ ├── agents/ # Definições de agents |
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.
In `@docs/pt/contributing.md` at line 429, Replace the incorrect directory name
string ".aiox-core/" with the correct repository directory ".aios-core/" in the
docs entry; locate the line that currently contains ".aiox-core/" (in the
contributing.md content block) and update that token to ".aios-core/" so
documentation matches the actual repository layout.
| - **GitHub Issues:** [Abra uma issue](https://github.com/SynkraAI/aiox-core/issues) | ||
| - **Discussões:** [Inicie uma discussão](https://github.com/SynkraAI/aiox-core/discussions) | ||
| - **Comunidade:** [Discussões](https://github.com/SynkraAI/aiox-core/discussions) | ||
|
|
There was a problem hiding this comment.
Incorrect repository name in all GitHub URLs: Should be "aios-core" not "aiox-core"
All GitHub URLs in this section reference aiox-core but the repository is aios-core.
🔧 Proposed fix
-- **GitHub Issues:** [Abra uma issue](https://github.com/SynkraAI/aiox-core/issues)
-- **Discussões:** [Inicie uma discussão](https://github.com/SynkraAI/aiox-core/discussions)
-- **Comunidade:** [Discussões](https://github.com/SynkraAI/aiox-core/discussions)
+- **GitHub Issues:** [Abra uma issue](https://github.com/SynkraAI/aios-core/issues)
+- **Discussões:** [Inicie uma discussão](https://github.com/SynkraAI/aios-core/discussions)
+- **Comunidade:** [Discussões](https://github.com/SynkraAI/aios-core/discussions)📝 Committable suggestion
‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.
| - **GitHub Issues:** [Abra uma issue](https://github.com/SynkraAI/aiox-core/issues) | |
| - **Discussões:** [Inicie uma discussão](https://github.com/SynkraAI/aiox-core/discussions) | |
| - **Comunidade:** [Discussões](https://github.com/SynkraAI/aiox-core/discussions) | |
| - **GitHub Issues:** [Abra uma issue](https://github.com/SynkraAI/aios-core/issues) | |
| - **Discussões:** [Inicie uma discussão](https://github.com/SynkraAI/aios-core/discussions) | |
| - **Comunidade:** [Discussões](https://github.com/SynkraAI/aios-core/discussions) |
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.
In `@docs/pt/contributing.md` around lines 528 - 531, The repository name is
incorrect in the three GitHub URLs (the strings containing
"https://github.com/SynkraAI/aiox-core") — update each occurrence to use
"aios-core" instead of "aiox-core" (e.g., the links for "Abra uma issue",
"Inicie uma discussão", and "Discussões") so the URLs point to
https://github.com/SynkraAI/aios-core.
| git clone https://github.com/SynkraAI/aiox-core.git | ||
| cd aiox-core |
There was a problem hiding this comment.
Incorrect repository name in Pro section: Should be "aios-core" not "aiox-core"
The Pro section git commands and references use aiox-core but the repository is aios-core.
🔧 Proposed fixes
-git clone https://github.com/SynkraAI/aiox-core.git
-cd aiox-core
+git clone https://github.com/SynkraAI/aios-core.git
+cd aios-core-git clone --recurse-submodules https://github.com/SynkraAI/aiox-core.git
+git clone --recurse-submodules https://github.com/SynkraAI/aios-core.git-**Ordem de push:** Sempre faça push das alterações do `pro/` primeiro, depois do `aiox-core`.
+**Ordem de push:** Sempre faça push das alterações do `pro/` primeiro, depois do `aios-core`.Also applies to: 554-554, 560-560
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.
In `@docs/pt/contributing.md` around lines 543 - 544, The Pro section uses the
wrong repository name "aiox-core" in the git commands and references; replace
every occurrence of the string "aiox-core" (e.g., the git clone and cd lines and
other Pro-section mentions) with the correct repository name "aios-core", and
update any corresponding URLs or links to match
"https://github.com/SynkraAI/aios-core" to ensure the commands and references
are accurate.
|
@Pedrovaleriolopez @oalanicolas, esse PR de tradução do CONTRIBUTING.md tá aberto desde 18/fev — quase 3 semanas. É só docs, sem risco nenhum. Enquanto isso PRs de pessoas que chegaram depois já foram mergeados (#581). Posso ajudar com qualquer ajuste necessário pra aprovar — só falar. |
Summary
CONTRIBUTING.mdasCONTRIBUTING-PT.md[Versao em Portugues](CONTRIBUTING-PT.md)) but the file did not exist — this PR creates it[English Version](CONTRIBUTING.md)at the top of the Portuguese versionCloses #206
Test plan
CONTRIBUTING.mdline 3 now resolves toCONTRIBUTING-PT.mdCONTRIBUTING-PT.mdresolves toCONTRIBUTING.mdcc @Pedrovaleriolopez
Summary by CodeRabbit