diff --git a/translations/it/.co-op-translator.json b/translations/it/.co-op-translator.json index 3ac3f8189..507b1c277 100644 --- a/translations/it/.co-op-translator.json +++ b/translations/it/.co-op-translator.json @@ -493,7 +493,7 @@ }, "AGENTS.md": { "original_hash": "a362efd06d64d4134a0cfe8515a86d34", - "translation_date": "2026-02-06T08:31:29+00:00", + "translation_date": "2026-02-06T11:25:08+00:00", "source_file": "AGENTS.md", "language_code": "it" }, diff --git a/translations/it/AGENTS.md b/translations/it/AGENTS.md index acd203d14..e47a6eb8d 100644 --- a/translations/it/AGENTS.md +++ b/translations/it/AGENTS.md @@ -2,21 +2,21 @@ ## Panoramica del Progetto -Questo è un repository curriculare educativo per insegnare le basi dello sviluppo web ai principianti. Il curriculum è un corso completo di 12 settimane sviluppato dai Microsoft Cloud Advocates, con 24 lezioni pratiche che coprono JavaScript, CSS e HTML. +Questo è un repository di curriculum educativo per insegnare le basi dello sviluppo web ai principianti. Il curriculum è un corso completo di 12 settimane sviluppato dai Microsoft Cloud Advocates, che comprende 24 lezioni pratiche su JavaScript, CSS e HTML. ### Componenti Chiave - **Contenuti Educativi**: 24 lezioni strutturate organizzate in moduli basati su progetti - **Progetti Pratici**: Terrarium, Gioco di Digitazione, Estensione Browser, Gioco Spaziale, App Bancaria, Editor di Codice e Assistente Chat AI -- **Quiz Interattivi**: 48 quiz con 3 domande ciascuno (valutazioni pre/post lezione) -- **Supporto Multilingue**: Traduzioni automatizzate in oltre 50 lingue tramite GitHub Actions +- **Quiz Interattivi**: 48 quiz con 3 domande ciascuno (valutazioni pre/post-lezione) +- **Supporto Multilingue**: Traduzioni automatiche in oltre 50 lingue tramite GitHub Actions - **Tecnologie**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (per progetti AI) ### Architettura - Repository educativo con struttura basata sulle lezioni -- Ogni cartella lezione contiene README, esempi di codice e soluzioni -- Progetti indipendenti in directory separate (quiz-app, vari progetti delle lezioni) +- Ogni cartella di lezione contiene README, esempi di codice e soluzioni +- Progetti indipendenti in directory separate (quiz-app, vari progetti di lezione) - Sistema di traduzione tramite GitHub Actions (co-op-translator) - Documentazione servita tramite Docsify e disponibile in PDF @@ -37,11 +37,11 @@ cd Web-Dev-For-Beginners cd quiz-app npm install npm run dev # Avvia il server di sviluppo -npm run build # Costruisci per la produzione +npm run build # Compila per la produzione npm run lint # Esegui ESLint ``` -### API Progetto Banca (Node.js + Express) +### API Progetto Bancario (Node.js + Express) ```bash cd 7-bank-project/api @@ -56,7 +56,7 @@ npm run format # Format con Prettier ```bash cd 5-browser-extension/solution npm install -# Seguire le istruzioni specifiche del browser per il caricamento dell'estensione +# Seguire le istruzioni specifiche del browser per il caricamento delle estensioni ``` ### Progetti Gioco Spaziale @@ -78,114 +78,114 @@ python api.py ## Flusso di Lavoro per lo Sviluppo -### Per i Collaboratori di Contenuti +### Per i Collaboratori di Contenuto -1. **Fork del repository** nel proprio account GitHub -2. **Clonare il fork** localmente -3. **Creare un nuovo branch** per le modifiche -4. Apportare modifiche ai contenuti delle lezioni o agli esempi di codice -5. Testare eventuali modifiche al codice nelle directory dei progetti rilevanti -6. Inviare pull request seguendo le linee guida di contributo +1. **Forka il repository** nel tuo account GitHub +2. **Clona il fork** localmente +3. **Crea un nuovo branch** per le tue modifiche +4. Apporta modifiche ai contenuti delle lezioni o agli esempi di codice +5. Testa eventuali cambiamenti di codice nelle directory di progetto pertinenti +6. Invia pull request seguendo le linee guida di contributo ### Per gli Studenti -1. Fork o clone del repository -2. Navigare sequenzialmente tra le cartelle delle lezioni -3. Leggere i file README di ogni lezione -4. Completare i quiz preliminari della lezione su https://ff-quizzes.netlify.app/web/ -5. Lavorare sugli esempi di codice nelle cartelle delle lezioni -6. Completare compiti e sfide -7. Sostenere i quiz post-lezione +1. Forka o clona il repository +2. Naviga nelle directory delle lezioni in sequenza +3. Leggi i file README di ogni lezione +4. Completa i quiz pre-lezione su https://ff-quizzes.netlify.app/web/ +5. Lavora sugli esempi di codice nelle cartelle delle lezioni +6. Completa compiti e sfide +7. Svolgi i quiz post-lezione ### Sviluppo Live -- **Documentazione**: Eseguire `docsify serve` nella root (porta 3000) -- **Quiz App**: Eseguire `npm run dev` nella cartella quiz-app -- **Progetti**: Usare l’estensione Live Server di VS Code per progetti HTML -- **Progetti API**: Eseguire `npm start` nelle rispettive directory API +- **Documentazione**: Esegui `docsify serve` nella root (porta 3000) +- **Quiz App**: Esegui `npm run dev` nella cartella quiz-app +- **Progetti**: Usa l’estensione Live Server di VS Code per i progetti HTML +- **Progetti API**: Esegui `npm start` nelle rispettive directory API ## Istruzioni per i Test -### Test per Quiz App +### Test Quiz App ```bash cd quiz-app -npm run lint # Controlla problemi di stile del codice +npm run lint # Controlla i problemi di stile del codice npm run build # Verifica che la compilazione abbia successo ``` -### Test per API Bancaria +### Test API Bancaria ```bash cd 7-bank-project/api -npm run lint # Controlla problemi di stile del codice +npm run lint # Controlla la presenza di problemi di stile del codice node server.js # Verifica che il server si avvii senza errori ``` ### Approccio Generale ai Test -- Questo è un repository educativo senza test automatici completi +- Questo è un repository educativo senza test automatizzati completi - I test manuali si concentrano su: - - Esecuzione senza errori degli esempi di codice - - Funzionamento corretto dei link nella documentazione - - Completamento senza errori delle build dei progetti - - Rispetto delle best practice negli esempi + - Esempi di codice eseguiti senza errori + - Link nella documentazione funzionanti correttamente + - Compilazioni di progetto completate con successo + - Esempi conformi alle migliori pratiche -### Controlli Prima della Sottomissione +### Controlli Pre-Invio -- Eseguire `npm run lint` nelle directory con package.json -- Verificare che i link markdown siano validi -- Testare gli esempi di codice in browser o Node.js -- Controllare che le traduzioni mantengano la struttura corretta +- Esegui `npm run lint` nelle directory con package.json +- Verifica che i link markdown siano validi +- Testa gli esempi di codice in browser o Node.js +- Assicurati che le traduzioni mantengano la struttura corretta ## Linee Guida per lo Stile del Codice ### JavaScript -- Usare sintassi moderna ES6+ -- Seguire le configurazioni ESLint standard fornite nei progetti -- Usare nomi di variabili e funzioni significativi per chiarezza educativa -- Aggiungere commenti che spieghino i concetti agli studenti -- Formattare con Prettier dove configurato +- Usa sintassi moderna ES6+ +- Segui le configurazioni ESLint standard fornite nei progetti +- Usa nomi di variabili e funzioni significativi per chiarezza educativa +- Aggiungi commenti che spiegano i concetti per gli studenti +- Formattta con Prettier dove configurato ### HTML/CSS -- Elementi HTML5 semantici -- Principi di design responsive -- Convenzioni chiare per il naming delle classi +- Elementi semantici HTML5 +- Principi di design responsivo +- Convenzioni di nomi di classi chiare - Commenti che spiegano le tecniche CSS per gli studenti ### Python - Linee guida di stile PEP 8 - Esempi di codice chiari ed educativi -- Usare type hint ove utili per l’apprendimento +- Indicazioni di tipo (type hints) dove utili per l’apprendimento ### Documentazione Markdown -- Gerarchia chiara dei titoli +- Gerarchia chiara delle intestazioni - Blocchi di codice con specifica del linguaggio - Link a risorse aggiuntive -- Schermate e immagini nelle cartelle `images/` -- Testo alternativo per immagini per l’accessibilità +- Screenshot e immagini nelle cartelle `images/` +- Testo alternativo per le immagini a scopo di accessibilità ### Organizzazione dei File - Lezioni numerate in modo sequenziale (1-getting-started-lessons, 2-js-basics, ecc.) - Ogni progetto ha cartelle `solution/` e spesso `start/` o `your-work/` -- Immagini salvate in cartelle `images/` specifiche di ogni lezione +- Immagini conservate nelle cartelle `images/` specifiche delle lezioni - Traduzioni nella struttura `translations/{language-code}/` -## Build e Distribuzione +## Build e Deployment -### Distribuzione Quiz App (Azure Static Web Apps) +### Deployment Quiz App (Azure Static Web Apps) -La quiz-app è configurata per la distribuzione su Azure Static Web Apps: +La quiz-app è configurata per il deployment su Azure Static Web Apps: ```bash cd quiz-app npm run build # Crea la cartella dist/ -# Distribuisce tramite il flusso di lavoro GitHub Actions su push verso main +# Distribuisce tramite il flusso di lavoro GitHub Actions al push su main ``` Configurazione Azure Static Web Apps: @@ -207,76 +207,76 @@ npm install -g docsify-cli # Installa Docsify globalmente docsify serve # Servi su localhost:3000 ``` -### Build Specifiche per Progetto +### Build Specifico per Progetto -Ogni directory progetto può avere il proprio processo di build: +Ogni directory di progetto può avere il proprio processo di build: - Progetti Vue: `npm run build` crea bundle di produzione -- Progetti statici: Nessun passaggio di build, servire file direttamente +- Progetti statici: nessun passaggio di build, servire i file direttamente ## Linee Guida per le Pull Request ### Formato del Titolo -Usare titoli chiari e descrittivi che indichino l’area di modifica: +Usa titoli chiari e descrittivi che indichino l’area di modifica: - `[Quiz-app] Aggiungi nuovo quiz per la lezione X` -- `[Lesson-3] Correzione di refuso nel progetto terrarium` -- `[Translation] Aggiunta traduzione spagnola per la lezione 5` -- `[Docs] Aggiornamento istruzioni di configurazione` +- `[Lesson-3] Correggi errore nel progetto terrarium` +- `[Translation] Aggiungi traduzione spagnola per la lezione 5` +- `[Docs] Aggiorna istruzioni di configurazione` ### Controlli Richiesti Prima di inviare una PR: 1. **Qualità del Codice**: - - Eseguire `npm run lint` nelle directory di progetto coinvolte - - Correggere tutti gli errori e avvisi di linting + - Esegui `npm run lint` nelle directory di progetto interessate + - Risolvi tutti gli errori e avvisi di linting 2. **Verifica Build**: - - Eseguire `npm run build` se applicabile - - Assicurarsi che non ci siano errori di build + - Esegui `npm run build` se applicabile + - Assicurati che non ci siano errori di build 3. **Validazione Link**: - - Testare tutti i link markdown - - Verificare il corretto funzionamento dei riferimenti alle immagini + - Testa tutti i link markdown + - Verifica che i riferimenti alle immagini funzionino 4. **Revisione Contenuti**: - - Controllare ortografia e grammatica - - Assicurarsi che gli esempi di codice siano corretti ed educativi - - Verificare che le traduzioni mantengano il significato originale + - Controlla ortografia e grammatica + - Verifica che gli esempi di codice siano corretti ed educativi + - Assicurati che le traduzioni mantengano il significato originale -### Requisiti per il Contributo +### Requisiti di Contributo -- Accettare la Microsoft CLA (verifica automatica alla prima PR) -- Seguire il [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) -- Consultare [CONTRIBUTING.md](./CONTRIBUTING.md) per linee guida dettagliate -- Citare numeri di issue nella descrizione PR se applicabile +- Accetta il Microsoft CLA (verifica automatica alla prima PR) +- Segui il [Codice di Condotta Microsoft Open Source](https://opensource.microsoft.com/codeofconduct/) +- Vedi [CONTRIBUTING.md](./CONTRIBUTING.md) per dettagli +- Riferisci i numeri delle issue nella descrizione della PR se necessario ### Processo di Revisione -- Le PR sono revisionate da mantenitori e comunità -- Si privilegia la chiarezza educativa -- Gli esempi di codice devono seguire le best practice correnti -- Le traduzioni sono revisionate per accuratezza e adeguatezza culturale +- Le PR sono revisionate da manutentori e comunità +- La chiarezza educativa è prioritaria +- Gli esempi di codice devono seguire le migliori pratiche attuali +- Le traduzioni sono verificate per accuratezza e idoneità culturale ## Sistema di Traduzione -### Traduzione Automatizzata +### Traduzione Automatica - Usa GitHub Actions con workflow co-op-translator - Traduce automaticamente in oltre 50 lingue - File sorgente nelle directory principali -- File tradotti in directory `translations/{language-code}/` +- File tradotti in `translations/{language-code}/` -### Aggiunta di Migliorie Manuali alle Traduzioni +### Aggiunta di Miglioramenti Manuali alla Traduzione -1. Localizzare i file in `translations/{language-code}/` -2. Apportare migliorie preservando struttura -3. Assicurarsi che gli esempi di codice rimangano funzionanti -4. Testare eventuali contenuti quiz localizzati +1. Trova il file in `translations/{language-code}/` +2. Apporta miglioramenti mantenendo la struttura +3. Assicurati che gli esempi di codice restino funzionanti +4. Testa eventuali contenuti quiz localizzati -### Metadata della Traduzione +### Metadata di Traduzione -I file tradotti includono header metadata: +I file tradotti includono intestazione metadata: ```markdown **Disclaimer**: -Questo documento è stato tradotto utilizzando il servizio di traduzione automatica AI [Co-op Translator](https://github.com/Azure/co-op-translator). Pur impegnandoci per garantire l’accuratezza, si prega di tenere presente che le traduzioni automatiche possono contenere errori o inesattezze. Il documento originale nella sua lingua nativa deve essere considerato la fonte autorevole. Per informazioni critiche, si raccomanda una traduzione professionale effettuata da un esperto. Non ci assumiamo alcuna responsabilità per incomprensioni o interpretazioni errate derivanti dall’uso di questa traduzione. +Questo documento è stato tradotto utilizzando il servizio di traduzione AI [Co-op Translator](https://github.com/Azure/co-op-translator). Pur impegnandoci per garantire l’accuratezza, si prega di notare che le traduzioni automatizzate possono contenere errori o inesattezze. Il documento originale nella sua lingua nativa deve essere considerato la fonte autorevole. Per informazioni critiche, si consiglia una traduzione professionale eseguita da un umano. Non ci assumiamo alcuna responsabilità per eventuali malintesi o interpretazioni errate derivanti dall’uso di questa traduzione. \ No newline at end of file diff --git a/translations/pt-BR/.co-op-translator.json b/translations/pt-BR/.co-op-translator.json index 94a1f420d..eca9b7113 100644 --- a/translations/pt-BR/.co-op-translator.json +++ b/translations/pt-BR/.co-op-translator.json @@ -493,7 +493,7 @@ }, "AGENTS.md": { "original_hash": "a362efd06d64d4134a0cfe8515a86d34", - "translation_date": "2026-02-06T08:30:13+00:00", + "translation_date": "2026-02-06T11:23:58+00:00", "source_file": "AGENTS.md", "language_code": "pt-BR" }, diff --git a/translations/pt-BR/AGENTS.md b/translations/pt-BR/AGENTS.md index bf9fe00f8..454d97263 100644 --- a/translations/pt-BR/AGENTS.md +++ b/translations/pt-BR/AGENTS.md @@ -2,20 +2,20 @@ ## Visão Geral do Projeto -Este é um repositório de currículo educacional para ensinar fundamentos de desenvolvimento web para iniciantes. O currículo é um curso abrangente de 12 semanas desenvolvido por Microsoft Cloud Advocates, com 24 aulas práticas cobrindo JavaScript, CSS e HTML. +Este é um repositório curricular educacional para ensinar fundamentos de desenvolvimento web para iniciantes. O currículo é um curso abrangente de 12 semanas desenvolvido pelos Microsoft Cloud Advocates, com 24 aulas práticas que cobrem JavaScript, CSS e HTML. ### Componentes Principais - **Conteúdo Educacional**: 24 aulas estruturadas organizadas em módulos baseados em projetos -- **Projetos Práticos**: Terrário, Jogo de Digitação, Extensão de Navegador, Jogo Espacial, Aplicativo Bancário, Editor de Código e Assistente de Chat AI -- **Quizzes Interativos**: 48 quizzes com 3 perguntas cada (avaliações pré e pós-aula) -- **Suporte Multilíngue**: Traduções automáticas para mais de 50 idiomas via GitHub Actions -- **Tecnologias**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (para projetos de AI) +- **Projetos Práticos**: Terrarium, Jogo de Digitação, Extensão de Navegador, Jogo Espacial, Aplicativo Bancário, Editor de Código e Assistente de Chat com IA +- **Quizzes Interativos**: 48 quizzes com 3 perguntas cada (avaliações pré e pós aula) +- **Suporte Multilíngue**: Traduções automatizadas para mais de 50 idiomas via GitHub Actions +- **Tecnologias**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (para projetos de IA) ### Arquitetura - Repositório educacional com estrutura baseada em aulas -- Cada pasta de aula contém README, exemplos de código e soluções +- Cada pasta da aula contém README, exemplos de código e soluções - Projetos independentes em diretórios separados (quiz-app, vários projetos de aula) - Sistema de tradução usando GitHub Actions (co-op-translator) - Documentação servida via Docsify e disponível em PDF @@ -41,7 +41,7 @@ npm run build # Construir para produção npm run lint # Executar ESLint ``` -### Projeto API do Banco (Node.js + Express) +### API do Projeto Bancário (Node.js + Express) ```bash cd 7-bank-project/api @@ -51,15 +51,15 @@ npm run lint # Executar ESLint npm run format # Formatar com Prettier ``` -### Projetos de Extensão de Navegador +### Projetos de Extensão para Navegador ```bash cd 5-browser-extension/solution npm install -# Siga as instruções específicas do navegador para carregar a extensão +# Siga as instruções específicas do navegador para carregar extensões ``` -### Projetos de Jogo Espacial +### Projetos do Jogo Espacial ```bash cd 6-space-game/solution @@ -67,12 +67,12 @@ npm install # Abra index.html no navegador ou use o Live Server ``` -### Projeto de Chat (Backend Python) +### Projeto de Chat (Backend em Python) ```bash cd 9-chat-project/solution/backend/python pip install openai -# Defina a variável de ambiente GITHUB_TOKEN +# Definir a variável de ambiente GITHUB_TOKEN python api.py ``` @@ -80,19 +80,19 @@ python api.py ### Para Contribuidores de Conteúdo -1. **Faça um fork do repositório** para sua conta no GitHub +1. **Faça um fork** do repositório para sua conta do GitHub 2. **Clone seu fork** localmente 3. **Crie uma nova branch** para suas alterações 4. Faça mudanças no conteúdo das aulas ou exemplos de código -5. Teste quaisquer alterações de código nos diretórios dos projetos relevantes +5. Teste quaisquer mudanças de código nos diretórios de projeto relevantes 6. Envie pull requests seguindo as diretrizes de contribuição ### Para Aprendizes 1. Faça fork ou clone do repositório -2. Navegue sequentialmente pelos diretórios das aulas +2. Navegue para os diretórios das aulas sequencialmente 3. Leia os arquivos README de cada aula -4. Complete os quizzes pré-aula em https://ff-quizzes.netlify.app/web/ +4. Complete quizzes pré-aula em https://ff-quizzes.netlify.app/web/ 5. Trabalhe nos exemplos de código nas pastas das aulas 6. Complete tarefas e desafios 7. Faça os quizzes pós-aula @@ -102,19 +102,19 @@ python api.py - **Documentação**: Execute `docsify serve` na raiz (porta 3000) - **Quiz App**: Execute `npm run dev` no diretório quiz-app - **Projetos**: Use a extensão Live Server do VS Code para projetos HTML -- **Projetos API**: Execute `npm start` nos diretórios API respectivos +- **Projetos API**: Execute `npm start` nos respectivos diretórios de API -## Instruções de Teste +## Instruções para Testes -### Teste do Quiz App +### Testes do Quiz App ```bash cd quiz-app npm run lint # Verificar problemas de estilo de código -npm run build # Verificar se a construção é bem-sucedida +npm run build # Verificar se a compilação foi bem-sucedida ``` -### Teste da API do Banco +### Testes da API Bancária ```bash cd 7-bank-project/api @@ -124,19 +124,19 @@ node server.js # Verifique se o servidor inicia sem erros ### Abordagem Geral de Teste -- Este é um repositório educacional sem testes automatizados completos +- Este é um repositório educacional sem testes automatizados abrangentes - Testes manuais focam em: - - Exemplos de código rodando sem erros - - Links na documentação funcionando corretamente - - Builds dos projetos completando com sucesso - - Exemplos seguindo boas práticas + - Exemplos de código que executam sem erros + - Links na documentação funcionam corretamente + - Build dos projetos completam com sucesso + - Exemplos seguem as melhores práticas -### Verificações Pré-envio +### Verificações Antes da Submissão -- Execute `npm run lint` em diretórios com package.json +- Execute `npm run lint` nos diretórios que possuem package.json - Verifique se os links markdown são válidos - Teste os exemplos de código no navegador ou Node.js -- Confira se traduções mantêm a estrutura correta +- Certifique-se de que as traduções mantêm a estrutura adequada ## Diretrizes de Estilo de Código @@ -145,21 +145,21 @@ node server.js # Verifique se o servidor inicia sem erros - Use sintaxe moderna ES6+ - Siga as configurações padrão do ESLint fornecidas nos projetos - Use nomes significativos para variáveis e funções para clareza educacional -- Adicione comentários explicativos para os aprendizes -- Formate com Prettier onde configurado +- Adicione comentários explicando conceitos para aprendizes +- Formate usando Prettier onde configurado ### HTML/CSS - Elementos semânticos HTML5 - Princípios de design responsivo -- Convenções claras de nomes de classes +- Convenções claras de nomenclatura de classes - Comentários explicando técnicas CSS para aprendizes ### Python - Diretrizes de estilo PEP 8 -- Exemplos de código claros e educacionais -- Tipos (type hints) onde úteis para aprendizado +- Exemplos de código claros e educativos +- Tipagem (type hints) quando útil para o aprendizado ### Documentação Markdown @@ -173,19 +173,19 @@ node server.js # Verifique se o servidor inicia sem erros - Aulas numeradas sequencialmente (1-getting-started-lessons, 2-js-basics, etc.) - Cada projeto tem diretórios `solution/` e frequentemente `start/` ou `your-work/` -- Imagens armazenadas nas pastas `images/` específicas das aulas +- Imagens armazenadas nas pastas `images/` específicas de cada aula - Traduções na estrutura `translations/{language-code}/` -## Build e Deploy +## Build e Implantação -### Deploy do Quiz App (Azure Static Web Apps) +### Implantação do Quiz App (Azure Static Web Apps) -O quiz-app está configurado para deployment no Azure Static Web Apps: +O quiz-app está configurado para implantação no Azure Static Web Apps: ```bash cd quiz-app npm run build # Cria a pasta dist/ -# Faz o deploy via fluxo de trabalho do GitHub Actions ao dar push no main +# Faz o deploy via workflow do GitHub Actions no push para a branch main ``` Configuração do Azure Static Web Apps: @@ -196,8 +196,8 @@ Configuração do Azure Static Web Apps: ### Geração de PDF da Documentação ```bash -npm install # Instale o docsify-to-pdf -npm run convert # Gere PDF a partir do docs +npm install # Instalar docsify-to-pdf +npm run convert # Gerar PDF a partir dos docs ``` ### Documentação Docsify @@ -207,72 +207,72 @@ npm install -g docsify-cli # Instalar Docsify globalmente docsify serve # Servir em localhost:3000 ``` -### Builds específicos de projeto +### Builds Específicos de Projeto Cada diretório de projeto pode ter seu próprio processo de build: -- Projetos Vue: `npm run build` cria bundles para produção -- Projetos estáticos: Nenhum passo de build, serve arquivos diretamente +- Projetos Vue: `npm run build` cria bundles de produção +- Projetos estáticos: Sem etapa de build, serve arquivos diretamente -## Diretrizes para Pull Request +## Diretrizes para Pull Requests -### Formatação do Título +### Formato do Título Use títulos claros e descritivos indicando a área da mudança: -- `[Quiz-app] Adiciona novo quiz para a aula X` -- `[Lesson-3] Corrige erro de digitação no projeto terrário` -- `[Translation] Adiciona tradução para espanhol na aula 5` -- `[Docs] Atualiza instruções de configuração` +- `[Quiz-app] Adicionar novo quiz para a aula X` +- `[Lesson-3] Corrigir erro de digitação no projeto terrarium` +- `[Translation] Adicionar tradução para espanhol na aula 5` +- `[Docs] Atualizar instruções de configuração` -### Verificações Obrigatórias +### Verificações Necessárias Antes de enviar um PR: -1. **Qualidade de Código**: +1. **Qualidade do Código**: - Execute `npm run lint` nos diretórios afetados - - Corrija todos erros e avisos do lint + - Corrija todos os erros e avisos do lint 2. **Verificação do Build**: - - Execute `npm run build`, se aplicável - - Garanta que não haja erros no build + - Execute `npm run build` se aplicável + - Certifique-se de que não há erros de build -3. **Validação de Links**: +3. **Validação dos Links**: - Teste todos os links markdown - - Verifique se as imagens são referenciadas corretamente + - Verifique funcionamento das referências de imagem 4. **Revisão de Conteúdo**: - - Revisão ortográfica e gramatical - - Certifique-se que os exemplos de código estão corretos e educativos - - Verifique se traduções mantêm o significado original + - Revise ortografia e gramática + - Assegure que os exemplos de código estão corretos e educativos + - Verifique se as traduções mantêm o significado original ### Requisitos para Contribuição -- Concordar com o CLA da Microsoft (verificação automática no primeiro PR) +- Aceitar o CLA da Microsoft (verificação automática no primeiro PR) - Seguir o [Código de Conduta Open Source da Microsoft](https://opensource.microsoft.com/codeofconduct/) -- Veja [CONTRIBUTING.md](./CONTRIBUTING.md) para diretrizes detalhadas -- Referenciar números de issues na descrição do PR, se aplicável +- Confira o [CONTRIBUTING.md](./CONTRIBUTING.md) para diretrizes detalhadas +- Referencie números de issues na descrição do PR, se aplicável ### Processo de Revisão - PRs são revisados por mantenedores e comunidade -- Clareza educacional é priorizada +- Clareza educacional é prioridade - Exemplos de código devem seguir as melhores práticas atuais -- Traduções revisadas quanto à precisão e adequação cultural +- Traduções são revisadas para precisão e adequação cultural ## Sistema de Tradução -### Tradução Automática +### Tradução Automatizada - Usa GitHub Actions com workflow co-op-translator -- Traduz automaticamente para mais de 50 idiomas +- Tradução automática para mais de 50 idiomas - Arquivos fonte nos diretórios principais -- Arquivos traduzidos em `translations/{language-code}/` +- Arquivos traduzidos em diretórios `translations/{language-code}/` -### Adicionando Melhorias Manuais de Tradução +### Adicionando Melhorias Manuais nas Traduções 1. Localize o arquivo em `translations/{language-code}/` 2. Faça melhorias preservando a estrutura -3. Garanta que exemplos de código continuem funcionais -4. Teste conteúdo de quiz localizado +3. Assegure que exemplos de código continuam funcionando +4. Teste qualquer conteúdo de quiz localizado ### Metadados de Tradução @@ -289,56 +289,56 @@ CO_OP_TRANSLATOR_METADATA: --> ``` -## Depuração e Resolução de Problemas +## Depuração e Solução de Problemas ### Problemas Comuns -**Quiz app não inicia**: +**App de quiz não inicia**: - Verifique a versão do Node.js (recomendado v14+) -- Apague `node_modules` e `package-lock.json`, execute `npm install` novamente -- Verifique conflitos de porta (padrão: Vite usa porta 5173) +- Delete `node_modules` e `package-lock.json`, execute `npm install` novamente +- Verifique conflito de portas (padrão: Vite usa porta 5173) **Servidor API não inicia**: -- Verifique se a versão do Node.js atende ao mínimo (node >=10) -- Confira se a porta já está em uso -- Garanta todas dependências instaladas com `npm install` +- Verifique se versão do Node.js atende mínimo (node >=10) +- Cheque se a porta já está em uso +- Certifique-se que todas as dependências foram instaladas com `npm install` **Extensão de navegador não carrega**: -- Verifique se manifest.json está corretamente formatado -- Cheque erros no console do navegador -- Siga instruções específicas de instalação para o navegador +- Verifique se manifest.json está formatado corretamente +- Consulte console do navegador para erros +- Siga instruções específicas para instalação da extensão no navegador **Problemas no projeto de chat Python**: -- Certifique-se que o pacote OpenAI está instalado: `pip install openai` -- Verifique se a variável ambiente GITHUB_TOKEN está configurada -- Confira permissões de acesso aos modelos GitHub +- Confirme que pacote OpenAI está instalado: `pip install openai` +- Verifique se variável de ambiente GITHUB_TOKEN está configurada +- Confira permissões de acesso do GitHub Models **Docsify não serve a documentação**: -- Instale o docsify-cli globalmente: `npm install -g docsify-cli` -- Execute a partir da raiz do repositório -- Verifique se `docs/_sidebar.md` existe +- Instale docsify-cli globalmente: `npm install -g docsify-cli` +- Rode a partir do diretório raiz do repositório +- Confirme que `docs/_sidebar.md` existe ### Dicas para Ambiente de Desenvolvimento - Use VS Code com extensão Live Server para projetos HTML - Instale extensões ESLint e Prettier para formatação consistente -- Utilize DevTools do navegador para depurar JavaScript -- Para projetos Vue, instale a extensão Vue DevTools no navegador +- Use DevTools do navegador para depuração de JavaScript +- Para projetos Vue, instale extensão Vue DevTools no navegador ### Considerações de Performance -- Grande número de arquivos traduzidos (mais de 50 idiomas) torna clones completos grandes -- Use clone raso se trabalhar apenas no conteúdo: `git clone --depth 1` -- Exclua traduções de buscas quando trabalhar com conteúdo em inglês -- Processos de build podem ser lentos na primeira execução (npm install, build Vite) +- Grande número de arquivos traduzidos (50+ idiomas) torna clones completos grandes +- Use clone superficial se for trabalhar somente com conteúdo: `git clone --depth 1` +- Exclua traduções de buscas ao trabalhar com conteúdo em inglês +- Processos de build podem ser lentos na primeira execução (npm install, build do Vite) ## Considerações de Segurança ### Variáveis de Ambiente - Chaves de API nunca devem ser commitadas no repositório -- Use arquivos `.env` (já em `.gitignore`) -- Documente as variáveis de ambiente necessárias nos READMEs dos projetos +- Use arquivos `.env` (já incluídos no `.gitignore`) +- Documente variáveis de ambiente necessárias nos README dos projetos ### Projetos Python @@ -346,34 +346,34 @@ CO_OP_TRANSLATOR_METADATA: - Mantenha dependências atualizadas - Tokens do GitHub devem ter permissões mínimas necessárias -### Acesso aos Modelos do GitHub +### Acesso ao GitHub Models -- Tokens de Acesso Pessoal (PAT) necessários para Modelos GitHub +- Tokens pessoais de acesso (PAT) são necessários para acessar GitHub Models - Tokens devem ser armazenados como variáveis de ambiente -- Nunca commit tokens ou credenciais +- Nunca faça commit de tokens ou credenciais ## Notas Adicionais -### Público Alvo +### Público-alvo - Iniciantes completos em desenvolvimento web - Estudantes e autodidatas -- Professores utilizando o currículo em salas de aula +- Professores usando o currículo em sala de aula - Conteúdo projetado para acessibilidade e construção gradual de habilidades ### Filosofia Educacional -- Abordagem baseada em projetos +- Abordagem de aprendizagem baseada em projetos - Verificações frequentes de conhecimento (quizzes) -- Exercícios práticos de codificação +- Exercícios práticos de programação - Exemplos de aplicação no mundo real - Foco nos fundamentos antes dos frameworks ### Manutenção do Repositório -- Comunidade ativa de aprendizes e contribuidores -- Atualizações regulares de dependências e conteúdo -- Issues e discussões monitoradas por mantenedores +- Comunidade ativa de aprendizes e colaboradores +- Atualizações regulares nas dependências e conteúdo +- Monitoramento de issues e discussões pelos mantenedores - Atualizações de tradução automatizadas via GitHub Actions ### Recursos Relacionados @@ -381,28 +381,28 @@ CO_OP_TRANSLATOR_METADATA: - [Módulos Microsoft Learn](https://docs.microsoft.com/learn/) - [Recursos do Student Hub](https://docs.microsoft.com/learn/student-hub/) - [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) recomendado para aprendizes -- Cursos adicionais: AI Generativa, Data Science, ML, currículos IoT disponíveis +- Cursos adicionais: IA Generativa, Ciência de Dados, ML, currículos de IoT disponíveis ### Trabalhando com Projetos Específicos Para instruções detalhadas sobre projetos individuais, consulte os arquivos README em: -- `quiz-app/README.md` - aplicação de quiz Vue 3 -- `7-bank-project/README.md` - aplicativo bancário com autenticação -- `5-browser-extension/README.md` - desenvolvimento de extensão de navegador -- `6-space-game/README.md` - desenvolvimento de jogo baseado em canvas -- `9-chat-project/README.md` - projeto assistente de chat AI +- `quiz-app/README.md` - Aplicação de quiz Vue 3 +- `7-bank-project/README.md` - Aplicativo bancário com autenticação +- `5-browser-extension/README.md` - Desenvolvimento de extensão para navegador +- `6-space-game/README.md` - Desenvolvimento de jogo baseado em canvas +- `9-chat-project/README.md` - Projeto de assistente de chat com IA ### Estrutura Monorepo Embora não seja um monorepo tradicional, este repositório contém múltiplos projetos independentes: -- Cada aula é autônoma +- Cada aula é auto-suficiente - Projetos não compartilham dependências -- Trabalhe em projetos individuais sem afetar os outros -- Clone o repositório inteiro para a experiência completa do currículo +- Trabalhe em projetos individuais sem impactar os outros +- Clone o repositório completo para a experiência curricular completa --- **Aviso Legal**: -Este documento foi traduzido utilizando o serviço de tradução automática [Co-op Translator](https://github.com/Azure/co-op-translator). Embora nos esforcemos para garantir a precisão, esteja ciente de que traduções automáticas podem conter erros ou imprecisões. O documento original em sua língua nativa deve ser considerado a fonte autoritativa. Para informações críticas, recomenda-se a tradução profissional realizada por humanos. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações equivocadas decorrentes do uso desta tradução. +Este documento foi traduzido utilizando o serviço de tradução por IA [Co-op Translator](https://github.com/Azure/co-op-translator). Embora nos esforcemos pela precisão, esteja ciente de que traduções automáticas podem conter erros ou imprecisões. O documento original em seu idioma nativo deve ser considerado a fonte autorizada. Para informações críticas, recomenda-se tradução humana profissional. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações incorretas decorrentes do uso desta tradução. \ No newline at end of file diff --git a/translations/pt-PT/.co-op-translator.json b/translations/pt-PT/.co-op-translator.json index f74278384..9dd76f513 100644 --- a/translations/pt-PT/.co-op-translator.json +++ b/translations/pt-PT/.co-op-translator.json @@ -493,7 +493,7 @@ }, "AGENTS.md": { "original_hash": "a362efd06d64d4134a0cfe8515a86d34", - "translation_date": "2026-02-06T08:29:06+00:00", + "translation_date": "2026-02-06T11:22:54+00:00", "source_file": "AGENTS.md", "language_code": "pt-PT" }, diff --git a/translations/pt-PT/AGENTS.md b/translations/pt-PT/AGENTS.md index 53e858c44..b7e510802 100644 --- a/translations/pt-PT/AGENTS.md +++ b/translations/pt-PT/AGENTS.md @@ -2,14 +2,14 @@ ## Visão Geral do Projeto -Este é um repositório de currículo educacional para ensino dos fundamentos do desenvolvimento web a iniciantes. O currículo é um curso abrangente de 12 semanas desenvolvido por Microsoft Cloud Advocates, com 24 lições práticas cobrindo JavaScript, CSS e HTML. +Este é um repositório curricular educativo para ensinar fundamentos de desenvolvimento web a iniciantes. O currículo é um curso abrangente de 12 semanas desenvolvido pelos Microsoft Cloud Advocates, com 24 lições práticas cobrindo JavaScript, CSS e HTML. ### Componentes Principais -- **Conteúdo Educativo**: 24 lições estruturadas organizadas em módulos baseados em projetos -- **Projetos Práticos**: Terrário, Jogo de Digitação, Extensão de Navegador, Jogo Espacial, Aplicação Bancária, Editor de Código e Assistente de Chat com IA -- **Questionários Interativos**: 48 questionários com 3 perguntas cada (avaliações pré/pós-lição) -- **Suporte Multilíngue**: Traduções automáticas para mais de 50 idiomas via GitHub Actions +- **Conteúdo Educacional**: 24 lições estruturadas organizadas em módulos baseados em projetos +- **Projetos Práticos**: Terrarium, Jogo de Digitação, Extensão de Navegador, Jogo Espacial, Aplicação Bancária, Editor de Código e Assistente de Chat com IA +- **Questionários Interativos**: 48 quizzes com 3 perguntas cada (avaliações pré e pós lição) +- **Suporte Multilíngue**: Traduções automáticas para mais de 50 línguas via GitHub Actions - **Tecnologias**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (para projetos de IA) ### Arquitetura @@ -18,11 +18,11 @@ Este é um repositório de currículo educacional para ensino dos fundamentos do - Cada pasta de lição contém README, exemplos de código e soluções - Projetos independentes em diretórios separados (quiz-app, vários projetos de lições) - Sistema de tradução usando GitHub Actions (co-op-translator) -- Documentação servida via Docsify e disponível em PDF +- Documentação servida via Docsify e disponível como PDF ## Comandos de Configuração -Este repositório é principalmente para consumo de conteúdo educativo. Para trabalhar com projetos específicos: +Este repositório destina-se principalmente ao consumo de conteúdo educativo. Para trabalhar com projetos específicos: ### Configuração Principal do Repositório @@ -31,13 +31,13 @@ git clone https://github.com/microsoft/Web-Dev-For-Beginners.git cd Web-Dev-For-Beginners ``` -### Configuração do Quiz App (Vue 3 + Vite) +### Configuração Quiz App (Vue 3 + Vite) ```bash cd quiz-app npm install npm run dev # Iniciar servidor de desenvolvimento -npm run build # Compilar para produção +npm run build # Construir para produção npm run lint # Executar ESLint ``` @@ -48,7 +48,7 @@ cd 7-bank-project/api npm install npm start # Iniciar servidor API npm run lint # Executar ESLint -npm run format # Formatar com Prettier +npm run format # Formatado com Prettier ``` ### Projetos de Extensão de Navegador @@ -59,7 +59,7 @@ npm install # Siga as instruções específicas do navegador para carregar extensões ``` -### Projetos do Jogo Espacial +### Projetos de Jogo Espacial ```bash cd 6-space-game/solution @@ -67,7 +67,7 @@ npm install # Abra index.html no navegador ou use o Live Server ``` -### Projeto de Chat (Backend Python) +### Projeto de Chat (Backend em Python) ```bash cd 9-chat-project/solution/backend/python @@ -78,35 +78,35 @@ python api.py ## Fluxo de Trabalho de Desenvolvimento -### Para Contribuidores de Conteúdo +### Para Contribuintes de Conteúdo 1. **Fork do repositório** para a sua conta GitHub 2. **Clone o seu fork** localmente -3. **Crie uma nova branch** para suas alterações +3. **Crie uma nova branch** para as suas alterações 4. Faça alterações no conteúdo das lições ou exemplos de código -5. Teste quaisquer alterações de código nos diretórios relevantes dos projetos +5. Teste quaisquer alterações de código nos diretórios dos projetos relevantes 6. Submeta pull requests seguindo as diretrizes de contribuição ### Para Aprendizes -1. Fork ou clone o repositório +1. Faça fork ou clone do repositório 2. Navegue sequencialmente pelos diretórios das lições 3. Leia os ficheiros README de cada lição -4. Complete os questionários pré-lição em https://ff-quizzes.netlify.app/web/ -5. Trabalhe com os exemplos de código nas pastas das lições +4. Complete os quizzes pré-lição em https://ff-quizzes.netlify.app/web/ +5. Trabalhe os exemplos de código nas pastas das lições 6. Complete tarefas e desafios -7. Faça os questionários pós-lição +7. Faça os quizzes pós-lição ### Desenvolvimento em Tempo Real - **Documentação**: Execute `docsify serve` na raiz (porta 3000) - **Quiz App**: Execute `npm run dev` no diretório quiz-app - **Projetos**: Use a extensão Live Server do VS Code para projetos HTML -- **Projetos API**: Execute `npm start` nos diretórios API correspondentes +- **APIs**: Execute `npm start` nos respetivos diretórios das APIs -## Instruções de Teste +## Instruções de Testes -### Teste do Quiz App +### Testes do Quiz App ```bash cd quiz-app @@ -114,7 +114,7 @@ npm run lint # Verificar problemas de estilo de código npm run build # Verificar se a compilação é bem-sucedida ``` -### Teste da API do Banco +### Testes da API Bancária ```bash cd 7-bank-project/api @@ -124,73 +124,73 @@ node server.js # Verificar se o servidor inicia sem erros ### Abordagem Geral de Testes -- Este é um repositório educacional sem testes automáticos abrangentes -- O teste manual foca em: - - Exemplos de código executar sem erros - - Links na documentação funcionarem corretamente - - Compilações de projetos serem concluídas com sucesso - - Exemplos seguirem as melhores práticas +- Este é um repositório educativo sem testes automatizados completos +- Testes manuais focam em: + - Exemplos de código sem erros na execução + - Links na documentação funcionais + - Compilação bem-sucedida dos projetos + - Exemplos que seguem as melhores práticas -### Verificações Pré-submissão +### Verificações Antes da Submissão -- Execute `npm run lint` nos diretórios com package.json -- Verifique se os links markdown estão válidos -- Teste exemplos de código no browser ou Node.js +- Execute `npm run lint` em diretórios com package.json +- Verifique se os links markdown são válidos +- Teste exemplos de código no navegador ou Node.js - Confirme que traduções mantêm a estrutura correta ## Diretrizes de Estilo de Código ### JavaScript -- Use sintaxe moderna ES6+ -- Siga as configurações padrão do ESLint fornecidas nos projetos -- Use nomes de variáveis e funções significativos para clareza educativa -- Adicione comentários explicando conceitos para os aprendizes -- Formate usando Prettier onde configurado +- Utilize sintaxe moderna ES6+ +- Siga as configurações padrão ESLint fornecidas nos projetos +- Use nomes significativos para variáveis e funções para maior clareza educativa +- Adicione comentários explicativos para os conceitos apresentados aos alunos +- Formate com Prettier onde estiver configurado ### HTML/CSS -- Elementos semânticos HTML5 +- Use elementos HTML5 semânticos - Princípios de design responsivo - Convenções claras de nomes de classes -- Comentários explicando técnicas CSS para aprendizes +- Comentários que explicam técnicas CSS para os aprendizes ### Python - Diretrizes de estilo PEP 8 -- Exemplos de código claros e educativos -- Dicas de tipo onde úteis para o aprendizado +- Código claro e educativo +- Dicas de tipos onde úteis para aprendizagem ### Documentação Markdown -- Hierarquia clara de títulos +- Hierarquia clara de cabeçalhos - Blocos de código com especificação de linguagem - Links para recursos adicionais - Capturas de ecrã e imagens nas pastas `images/` -- Texto alternativo para imagens para acessibilidade +- Texto alternativo nas imagens para acessibilidade ### Organização de Ficheiros - Lições numeradas sequencialmente (1-getting-started-lessons, 2-js-basics, etc.) - Cada projeto tem diretórios `solution/` e frequentemente `start/` ou `your-work/` -- Imagens armazenadas em pastas `images/` específicas de cada lição -- Traduções em estrutura `translations/{language-code}/` +- Imagens armazenadas nas pastas `images/` específicas de cada lição +- Traduções na estrutura `translations/{language-code}/` -## Construção e Implantação +## Construção e Implementação -### Implantação do Quiz App (Azure Static Web Apps) +### Implementação do Quiz App (Azure Static Web Apps) -O quiz-app está configurado para implantação em Azure Static Web Apps: +O quiz-app está configurado para deployment no Azure Static Web Apps: ```bash cd quiz-app npm run build # Cria a pasta dist/ -# Desdobra através do fluxo de trabalho do GitHub Actions ao fazer push para main +# Desdobra através do fluxo de trabalho do GitHub Actions ao fazer push para a branch main ``` -Configuração Azure Static Web Apps: -- **Localização da app**: `/quiz-app` -- **Localização da saída**: `dist` +Configuração do Azure Static Web Apps: +- **Localização da App**: `/quiz-app` +- **Localização de saída**: `dist` - **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` ### Geração de PDF da Documentação @@ -203,80 +203,80 @@ npm run convert # Gerar PDF a partir do docs ### Documentação Docsify ```bash -npm install -g docsify-cli # Instalar Docsify globalmente +npm install -g docsify-cli # Instalar o Docsify globalmente docsify serve # Servir em localhost:3000 ``` -### Compilações Específicas de Projeto +### Builds Específicos de Projetos -Cada diretório de projeto pode ter seu próprio processo de build: +Cada diretório de projeto pode ter o seu próprio processo de build: - Projetos Vue: `npm run build` cria bundles de produção -- Projetos estáticos: Sem etapa de build, serve os ficheiros diretamente +- Projetos estáticos: Sem passo de build, servir os ficheiros diretamente ## Diretrizes para Pull Requests ### Formato do Título Use títulos claros e descritivos indicando a área da alteração: -- `[Quiz-app] Adicionar novo quiz para lição X` -- `[Lesson-3] Corrigir erro tipográfico no projeto terrário` -- `[Translation] Adicionar tradução em espanhol para lição 5` +- `[Quiz-app] Adicionar novo quiz para a lição X` +- `[Lição-3] Corrigir erro de digitação no projeto terrarium` +- `[Tradução] Adicionar tradução para espanhol na lição 5` - `[Docs] Atualizar instruções de configuração` -### Verificações Obrigatórias +### Verificações Requeridas Antes de submeter um PR: 1. **Qualidade do Código**: - - Execute `npm run lint` nos diretórios de projeto afetados - - Corrija todos os erros e avisos do lint + - Execute `npm run lint` nos diretórios dos projetos afetados + - Corrija todos os erros e avisos de lint 2. **Verificação de Build**: - Execute `npm run build` se aplicável - - Assegure-se de que não há erros de build + - Assegure que não haja erros de build 3. **Validação de Links**: - Teste todos os links markdown - - Verifique referências de imagem + - Verifique se referências a imagens funcionam 4. **Revisão de Conteúdo**: - Revise ortografia e gramática - Garanta que exemplos de código estão corretos e educativos - - Verifique se as traduções mantêm o significado original + - Confirme que traduções mantêm o significado original ### Requisitos para Contribuição - Concordar com o Microsoft CLA (verificação automática no primeiro PR) - Seguir o [Código de Conduta Open Source da Microsoft](https://opensource.microsoft.com/codeofconduct/) -- Consulte [CONTRIBUTING.md](./CONTRIBUTING.md) para diretrizes detalhadas -- Referencie números de issues na descrição do PR, se aplicável +- Consultar [CONTRIBUTING.md](./CONTRIBUTING.md) para diretrizes detalhadas +- Referenciar números de issues na descrição do PR quando aplicável ### Processo de Revisão -- PRs revisados por mantenedores e comunidade -- Clareza educativa é prioridade +- PRs revistos por mantenedores e comunidade +- Prioridade na clareza educativa - Exemplos de código devem seguir as melhores práticas atuais -- Traduções revisadas quanto à precisão e adequação cultural +- Traduções revistas quanto à precisão e adequação cultural ## Sistema de Tradução -### Tradução Automatizada +### Tradução Automática - Usa GitHub Actions com workflow co-op-translator -- Traduz automaticamente para mais de 50 idiomas -- Arquivos fonte nos diretórios principais -- Arquivos traduzidos em `translations/{language-code}/` +- Traduções automáticas para mais de 50 línguas +- Ficheiros fonte nas pastas principais +- Ficheiros traduzidos em diretórios `translations/{language-code}/` -### Adição de Melhorias Manuais nas Traduções +### Adição de Melhorias Manuais à Tradução 1. Localize o ficheiro em `translations/{language-code}/` 2. Faça melhorias preservando a estrutura -3. Assegure que os exemplos de código permanecem funcionais -4. Teste qualquer conteúdo de questionário localizado +3. Assegure que exemplos de código permanecem funcionais +4. Teste qualquer conteúdo de quiz localizado -### Metadados da Tradução +### Metadados das Traduções -Arquivos traduzidos incluem um cabeçalho de metadados: +Ficheiros traduzidos incluem header de metadados: ```markdown -**Aviso**: -Este documento foi traduzido utilizando o serviço de tradução automática [Co-op Translator](https://github.com/Azure/co-op-translator). Embora nos esforcemos por garantir a precisão, por favor tenha em conta que traduções automáticas podem conter erros ou imprecisões. O documento original na sua língua nativa deve ser considerado a fonte autorizada. Para informações críticas, recomenda-se tradução profissional por humanos. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações erradas decorrentes da utilização desta tradução. +**Aviso Legal**: +Este documento foi traduzido utilizando o serviço de tradução por IA [Co-op Translator](https://github.com/Azure/co-op-translator). Embora nos esforcemos para garantir a precisão, tenha em atenção que as traduções automáticas podem conter erros ou imprecisões. O documento original na sua língua nativa deve ser considerado a fonte oficial. Para informações críticas, recomenda-se tradução profissional humana. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações incorretas decorrentes do uso desta tradução. \ No newline at end of file