From cbfcd037a85d99f7b858b0438fd7abb2f0c115ab Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Tue, 19 Sep 2023 20:54:33 -0400 Subject: [PATCH 01/62] fix: revise translate --- translations/pt-br/sidebar.md | 10 ++++++++++ 1 file changed, 10 insertions(+) create mode 100644 translations/pt-br/sidebar.md diff --git a/translations/pt-br/sidebar.md b/translations/pt-br/sidebar.md new file mode 100644 index 00000000..33833659 --- /dev/null +++ b/translations/pt-br/sidebar.md @@ -0,0 +1,10 @@ +- Páginas + - [Introdução](/translations/pt-br/01-introdução.md) + - [O que é Open Source?](/translations/pt-br/02-o-que-é-open-source.md) + - [Por que Open Source?](/translations/pt-br/03-por-que-open-source.md) + - [Ferramentas utilizadas](/translations/pt-br/04-ferramentas-utilizadas.md) + - [Como Contribuir Para Open Source](/translations/pt-br/05-como-contribuir-para-open-source.md) + - [O segredo do sauce](/translations/pt-br/06-o-molho-secreto.md) + - [Conclusão](/translations/pt-br/07-conclusão.md) + - [Recursos Adicionais](/translations/pt-br/08-recursos-adicionais.md) + - [Glossário](/translations/pt-br/09-glossário.md) \ No newline at end of file From 6f5290509fba4d89966cbefdc44458e76c185abe Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Tue, 19 Sep 2023 15:21:05 -0400 Subject: [PATCH 02/62] translate: renamed file names in Portuguese --- .../pt-br/01-introdu\303\247\303\243o.md" | 67 +++++++++ .../pt-br/02-o-que-\303\251-open-source.md" | 69 +++++++++ translations/pt-br/03-por-que-open-source.md | 57 ++++++++ .../pt-br/04-ferramentas-utilizadas.md | 138 ++++++++++++++++++ .../05-como-contribuir-para-open-source.md | 28 ++++ translations/pt-br/06-o-molho-secreto.md | 81 ++++++++++ "translations/pt-br/07-conclus\303\243o.md" | 39 +++++ translations/pt-br/08-recursos-adicionais.md | 25 ++++ "translations/pt-br/09-gloss\303\241rio.md" | 88 +++++++++++ 9 files changed, 592 insertions(+) create mode 100644 "translations/pt-br/01-introdu\303\247\303\243o.md" create mode 100644 "translations/pt-br/02-o-que-\303\251-open-source.md" create mode 100644 translations/pt-br/03-por-que-open-source.md create mode 100644 translations/pt-br/04-ferramentas-utilizadas.md create mode 100644 translations/pt-br/05-como-contribuir-para-open-source.md create mode 100644 translations/pt-br/06-o-molho-secreto.md create mode 100644 "translations/pt-br/07-conclus\303\243o.md" create mode 100644 translations/pt-br/08-recursos-adicionais.md create mode 100644 "translations/pt-br/09-gloss\303\241rio.md" diff --git "a/translations/pt-br/01-introdu\303\247\303\243o.md" "b/translations/pt-br/01-introdu\303\247\303\243o.md" new file mode 100644 index 00000000..13f47212 --- /dev/null +++ "b/translations/pt-br/01-introdu\303\247\303\243o.md" @@ -0,0 +1,67 @@ +# Introdução + +Bem-vindo ao curso "Getting Started with Open Source"! +Este curso abrangente irá guiá-lo pelo fascinante mundo do open source e ajudá-lo a se tornar um colaborador ativo. +Ao final deste curso, você deve ter uma compreensão sólida de como encontrar, participar e contribuir para projetos de código aberto, bem como como desenvolver seu currículo de código aberto. +Mas primeiro, vamos preparar o cenário discutindo os pré-requisitos, objetivos e expectativas para este curso. + +## Pré-requisitos + +Antes de mergulhar no mundo do open source, é essencial ter uma compreensão básica dos conceitos de programação e alguma experiência trabalhando com código. +Embora o curso forneça exemplos e demonstrações, você obterá o máximo do material se tiver algum conhecimento prévio. + +Além disso, este curso pressupõe que você esteja familiarizado com o Git e o GitHub. +O Git é um sistema de controle de versão amplamente utilizado, e o GitHub é uma plataforma popular para hospedar e colaborar em repositórios Git. + +Se você ainda não está familiarizado com o Git e o GitHub, recomendamos que você reserve um tempo para aprender o básico antes de iniciar este curso. + +## Objetivos + +Ao longo deste curso, nossos principais objetivos são ajudá-lo a: + +1. **Entender o código aberto e seus benefícios**: exploraremos o conceito de código aberto, sua história e as inúmeras vantagens de contribuir para projetos de código aberto. +2. **Aprenda a encontrar projetos de código aberto**: descobrir projetos que se alinham com seus interesses e habilidades é crucial para uma experiência de código aberto gratificante. Apresentaremos a você ferramentas e técnicas para encontrar projetos para contribuir. +3. **Dominar as ferramentas e processos para contribuir**: forneceremos uma visão geral das ferramentas e processos essenciais para uma colaboração de código aberto bem-sucedida, como controle de versão, revisão de código e plataformas de comunicação. +4. **Adquira experiência prática**: seguindo exemplos e demonstrações, você terá a oportunidade de praticar suas habilidades e ganhar confiança em sua capacidade de contribuir para projetos de código aberto. +5. **Desenvolva seu currículo de código aberto**: mostrar suas contribuições de código aberto é vital para construir sua reputação na comunidade e demonstrar sua experiência para potenciais empregadores ou clientes. Discutiremos estratégias para desenvolver e manter seu currículo de código aberto. + +## Expectativas + +Este curso foi projetado para fornecer uma base sólida em colaboração de código aberto. +Embora cubramos uma variedade de tópicos e forneçamos exemplos, demonstrações e oportunidades para prática, é essencial ter expectativas realistas sobre o que você pode alcançar durante o curso. + +1. **A prática é crucial**: aprender sobre código aberto é apenas o começo; para se tornar um colaborador proficiente, você precisará praticar consistentemente. +Tenha em mente que quanto mais você contribuir para projetos de código aberto, mais aprenderá e crescerá como desenvolvedor. + +2. **A paciência é fundamental**: tornar-se proficiente em colaboração de código aberto leva tempo e esforço. Não se desanime se encontrar desafios ao longo do caminho; lembre-se de que toda contribuição, por menor que seja, é valiosa e ajuda a melhorar o projeto. + +3. **Engajamento com a comunidade**: o código aberto é mais do que apenas código; trata-se das pessoas que colaboram e contribuem para projetos. Engaje-se com a comunidade fazendo perguntas, compartilhando seu conhecimento e apoiando os outros. +Construir relacionamentos com outros colaboradores aprimorará sua experiência de código aberto e ajudará você a crescer como desenvolvedor. + +4. **Aprendizado contínuo**: o código aberto é um campo em rápida evolução, com novos projetos, ferramentas e tecnologias surgindo o tempo todo. Mantenha-se curioso e aberto para aprender, e aproveite os recursos, como documentação, tutoriais e fóruns da comunidade, para expandir seus conhecimentos e se manter atualizado com os últimos desenvolvimentos. + +5. **Desenvolvendo uma mentalidade de crescimento**: abrace os desafios e oportunidades que surgem com a colaboração de código aberto. Adote uma mentalidade de crescimento, que se concentra em aprendizado, melhoria e resiliência. Ao ver os obstáculos como oportunidades de crescimento, você estará mais bem equipado para navegar no complexo mundo do código aberto e alcançar o sucesso em suas contribuições. + +## Estrutura do curso + +Este curso é dividido em vários capítulos, cada um projetado para cobrir um aspecto específico da colaboração de código aberto: + +1. **Introdução:** Começaremos preparando o cenário para sua jornada de código aberto, discutindo pré-requisitos, objetivos e expectativas. +2. **O que é código aberto?:** Neste capítulo, exploraremos a definição de código aberto e sua história, fornecendo uma base sólida para entender o contexto da colaboração de código aberto. +3. **Por que código aberto?:** Vamos mergulhar nos benefícios do código aberto, incluindo acesso ao conhecimento, comunidade e desenvolvimento de habilidades. +4. **Ferramentas para ter sucesso:** Este capítulo apresentará as ferramentas essenciais para uma colaboração de código aberto bem-sucedida, incluindo GitHub, Git, CodeSee, VS Code e Discord. +5. **Como contribuir para o código aberto:** Neste capítulo, discutiremos o processo de encontrar projetos para trabalhar, enviar contribuições, embarcar em um novo projeto e o que esperar depois que sua contribuição for enviada. +6. **The Secret Sauce:** Este capítulo revelará as estratégias e técnicas para começar, ganhar tração em suas contribuições, +7. **Conclusão:** Encerraremos o curso com as principais conclusões e discutiremos os próximos passos em sua jornada de código aberto. + +Ao longo deste curso, forneceremos exemplos e demonstrações para ajudar a ilustrar conceitos-chave e fornecer oportunidades práticas de prática. Quando possível, apresentaremos projetos e ferramentas de código aberto do mundo real, como [OpenSauced](https://opensauced.pizza/), para demonstrar como aplicar as habilidades que você aprendeu. + +Por favor, note que enquanto esses exemplos e demonstrações são projetados para fornecer orientação e inspiração, sua própria jornada de código aberto pode ser diferente, dependendo de seus interesses, habilidades e projetos escolhidos. + +Use os exemplos e demos como ponto de partida, mas não tenha medo de explorar outros projetos, ferramentas e recursos à medida que você continua a aprender e crescer. + +## LFG 🚀 + +Agora que nos apresentamos, é hora de embarcar em sua jornada de código aberto! No próximo capítulo, mergulharemos na definição de código aberto e exploraremos sua história, preparando o cenário para uma compreensão mais profunda da colaboração de código aberto. Vamos começar! + +[Próximo Capítulo ->](./02-what-is-open-source.md) \ No newline at end of file diff --git "a/translations/pt-br/02-o-que-\303\251-open-source.md" "b/translations/pt-br/02-o-que-\303\251-open-source.md" new file mode 100644 index 00000000..847766eb --- /dev/null +++ "b/translations/pt-br/02-o-que-\303\251-open-source.md" @@ -0,0 +1,69 @@ +# O que é Open Source? + +Neste capítulo, vamos mergulhar no conceito de código aberto, sua definição e sua história. Obter uma compreensão profunda do código aberto ajudará você a apreciar o contexto em que estará a colaborar e contribuindo. + +## Definição + +O termo "código aberto" refere-se a um tipo de software cujo código-fonte é disponibilizado ao público, permitindo que qualquer pessoa visualize, use, modifique e distribua o código. Isso é em contraste com o software proprietário, onde o código-fonte é mantido em segredo e apenas o programa compilado é distribuído. O princípio básico por trás do código aberto é a ideia de colaboração e a crença de que o compartilhamento de conhecimento e recursos leva a um software melhor, mais confiável e mais inovador. + +Um software de código aberto é construído com base na premissa de que, quando muitas pessoas trabalham juntas, elas podem criar algo maior do que a soma das suas partes. Os contribuidores para projetos de código aberto vêm de origens diversas e trazem uma ampla gama de habilidades, experiências e perspetivas para a mesa. Essa diversidade de pensamento e experiência leva a um software mais robusto, inovador e confiável. + +### Licenças de código aberto + +Para que um software seja considerado de código aberto, ele deve ser lançado sob uma licença que conceda aos usuários o direito de acessar, modificar e distribuir o código-fonte. Existem inúmeras licenças de código aberto disponíveis, cada uma com o seu próprio conjunto de termos e condições. Algumas licenças de código aberto populares incluem a Licença MIT, a Licença Pública Geral GNU (GPL) e a Licença Apache. + +Essas licenças são cruciais porque garantem que o software permaneça aberto e acessível a todos. Ao conceder aos usuários o direito de visualizar, modificar e distribuir o código, as licenças de código aberto promovem uma cultura de colaboração, inovação e conhecimento compartilhado. + +## História breve do código aberto + +A ideia de compartilhar livremente conhecimento e recursos existe há séculos, mas o movimento de código aberto como o conhecemos hoje pode ser rastreado aos primeiros dias da computação. + +### Primeiros aparecimentos + +Nos anos 50 e 60, o software de computador era frequentemente agrupado com hardware, e o código-fonte era compartilhado livremente entre pesquisadores e desenvolvedores. Durante esse período, era comum que os programadores colaborassem, compartilhassem ideias e modificassem o código uns dos outros para melhorar e inovar. + +No entanto, na década de 1970, à medida que a indústria de software começou a crescer e a comercializar, as empresas começaram a ver o software como um ativo e começaram a restringir o acesso ao código-fonte. Essa mudança marcou o início da divisão entre software proprietário e o emergente movimento de código aberto. + +### O nascimento do software livre + +Como consequência da crescente restrição ao acesso ao código-fonte, o programador Richard Stallman fundou a Free Software Foundation (FSF) em 1985. O objetivo da FSF era promover o desenvolvimento e o uso de software livre, que eles definiram como software que concede aos usuários a liberdade de executar, estudar, compartilhar e modificar o código. Esse conceito é semelhante ao código aberto, mas enfatiza mais os aspectos éticos e políticos da liberdade de software. + +Stallman e a FSF passaram a desenvolver o Projeto GNU (que significa "GNU's Not Unix"), um esforço ambicioso para criar um sistema operativo completamente livre e aberto. Embora o Projeto GNU tenha fornecido muitos componentes essenciais, faltava uma peça crítica: um kernel livre e aberto, o componente central de um sistema operativo. + +### O surgimento do Linux + +Em 1991, um estudante finlandês de ciência da computação chamado Linus Torvalds desenvolveu um kernel livre e aberto chamado Linux. Quando combinado com o sistema GNU, o Linux formou um sistema operacional completo, livre e de código aberto que ainda é amplamente utilizado hoje. O sucesso do Linux ajudou a popularizar o conceito de código aberto e desencadeou uma onda de novos projetos, ferramentas e tecnologias. + +### A Iniciativa de Código Aberto(Open Source Initiative, abreviada OSI) + +Em 1998, Christine Peterson, diretora-executiva da Foresight, cunhou o termo "software de código aberto" como um [esforço deliberado para tornar este campo... mais compreensível para novatos e para negócios](https://opensource.com/article/18/2/coining-term-open-source-software). Ela, com Eric S. Raymond, Bruce Perens e outros desenvolvedores e defensores, criou então a Iniciativa de Código Aberto (Open Source Initiative, OSI) para espalhar mais conscientização sobre esse conceito. A partir daí, a OSI desenvolveu a definição de código aberto, um conjunto de critérios que o software deve atender para ser considerado de código aberto. Esses critérios incluem distribuição gratuita, disponibilidade de código-fonte, trabalhos derivados e integridade da licença. + +A OSI também criou a Licença de Código Aberto (Open Source License, OSL), uma licença de software que atende aos critérios de código aberto. A OSL foi posteriormente renomeada para Licença Pública Geral GNU (GPL), que é uma das licenças de código aberto mais populares e amplamente utilizadas. + +### O crescimento das comunidades de código aberto + +À medida que o movimento de código aberto ganhava força, inúmeras comunidades e plataformas surgiram para facilitar a colaboração e o compartilhamento de conhecimento. Alguns exemplos notáveis incluem: + +- **SourceForge**: Lançado em 1999, o SourceForge foi uma das primeiras plataformas baseadas na web a fornecer ferramentas e recursos para que os desenvolvedores colaborassem em projetos de código aberto. No auge, o SourceForge hospedava milhares de projetos e atraía milhões de usuários. +- **GitHub**: Fundado em 2008, o GitHub rapidamente se tornou a plataforma padrão para hospedar e colaborar em repositórios Git. Hoje, o GitHub é o lar de milhões de projetos de código aberto e possui uma comunidade vibrante de colaboradores de todo o mundo. +- **GitLab**: Lançado em 2011 como uma alternativa de código aberto ao GitHub, o GitLab oferece um conjunto de ferramentas e recursos para gerir repositórios Git, rastrear problemas e facilitar a colaboração. + +Essas plataformas desempenharam um papel crucial no fomento ao crescimento das comunidades de código aberto e na facilitação da contribuição e colaboração de desenvolvedores em projetos. + +### O crescimento do envolvimento corporativo + +Nos últimos anos, houve um aumento significativo do envolvimento corporativo em projetos de código aberto. Muitas empresas agora reconhecem o valor do código aberto e contribuem ativamente e apoiam vários projetos. Algumas empresas até foram tão longe a ponto de abrir seus próprios ferramentas e tecnologias internas, como o TensorFlow do Google e o React do Facebook. + +Este aumento do envolvimento corporativo não só levou a mais recursos e suporte para projetos de código aberto, mas também ajudou a legitimar o movimento de código aberto e incentivar uma adoção mais ampla. + +### A evolução do código aberto + +O movimento de código aberto percorreu um longo caminho desde os seus primórdios. Hoje, o software de código aberto está em toda parte, alimentando desde sites e aplicativos móveis até algoritmos de inteligência artificial e aprendizado de máquina. + +À medida que o código aberto continua a evoluir, novos projetos, ferramentas e tecnologias estão constantemente surgindo, empurrando os limites do que é possível e impulsionando a inovação em uma ampla gama de indústrias. + +O crescente interesse e adoção do código aberto também levaram a ecossistema de código aberto próspero de conferências, meetups e comunidades online onde os desenvolvedores podem se reunir para aprender, colaborar e compartilhar os seus conhecimentos. Ao participar desses eventos e se envolver com a comunidade de código aberto, você terá a oportunidade de expandir as suas habilidades, construir a sua rede e se manter atualizado com os últimos desenvolvimentos na �rea. + +No próximo capítulo, exploraremos os muitos benefícios de contribuir para projetos de código aberto e discutiremos como a colaboração de código aberto pode ajudá-lo a acessar conhecimento, se conectar com uma comunidade e desenvolver habilidades valiosas. + +[Próximo Capítulo ->](./03-why-open-source.md) \ No newline at end of file diff --git a/translations/pt-br/03-por-que-open-source.md b/translations/pt-br/03-por-que-open-source.md new file mode 100644 index 00000000..26a08c1f --- /dev/null +++ b/translations/pt-br/03-por-que-open-source.md @@ -0,0 +1,57 @@ +# Por que Open Source? + +Na seção anterior, exploramos o conceito de código aberto e sua história. Agora, vamos nos aprofundar nos muitos benefícios de contribuir para projetos de código aberto. Ao entender as vantagens da colaboração de código aberto, você estará mais bem equipado para aproveitar as oportunidades que ela apresenta e aproveitar ao máximo sua jornada de código aberto. + +## Acesso ao conhecimento + +Um dos principais benefícios de contribuir para projetos de código aberto é a oportunidade de acessar uma riqueza de conhecimento e recursos. Como contribuidor de código aberto, você poderá: + +1. **Aprenda com projetos reais**: Projetos de código aberto oferecem uma oportunidade única de estudar e aprender com bases de código do mundo real. Ao examinar como outros desenvolvedores enfrentaram problemas complexos, você pode obter insights sobre as melhores práticas, padrões de design e técnicas de ponta que pode aplicar aos seus próprios projetos. + +2. **Acesse perspetivas diversas**: Projetos de código aberto atraem contribuidores de todo o mundo, cada um trazendo seu próprio conjunto único de habilidades, experiências e perspectivas. Ao colaborar com outras pessoas, você pode ampliar sua compreensão de diferentes tecnologias, linguagens de programação e metodologias de desenvolvimento. + +3. **Mantenha-se atualizado com as últimas tendências**: A comunidade de código aberto geralmente está na vanguarda da inovação, com novos projetos, ferramentas e tecnologias constantemente surgindo. Ao participar de projetos de código aberto, você pode se manter atualizado com os últimos desenvolvimentos em sua área e aprender sobre tendências emergentes e melhores práticas. + +4. **Acesse recursos de alta qualidade**: A comunidade de código aberto é conhecida por seu compromisso em produzir documentação, tutoriais e outros recursos educacionais de alta qualidade. Ao aproveitar essa riqueza de conhecimento, você pode aprofundar sua compreensão de várias tecnologias e conceitos e continuar a crescer como desenvolvedor. + +## Acesso à comunidade + +A comunidade de código aberto é uma rede diversificada e global de desenvolvedores, entusiastas e defensores que compartilham uma paixão comum pela colaboração e compartilhamento de conhecimento. Ao contribuir para projetos de código aberto, você pode: + +1. **Conecte-se com pessoas com ideias semelhantes**: projetos de código aberto oferecem uma oportunidade de colaborar com outras pessoas que compartilham os seus interesses e paixões. Trabalhando juntos, você pode formar conexões e amizades duradouras que podem enriquecer sua vida pessoal e profissional. + +2. **Expanda a sua rede**: A comunidade de código aberto é vasta e interconectada, com inúmeros projetos, eventos e fóruns onde os desenvolvedores se reúnem para colaborar e compartilhar conhecimento. Ao participar dessas atividades, você pode expandir sua rede profissional e se conectar com potenciais mentores, colaboradores e até empregadores. + +3. **Desenvolva habilidades de comunicação e colaboração**: trabalhar em projetos de código aberto geralmente envolve colaborar com outras pessoas, remota ou pessoalmente. Isso pode ajudá-lo a desenvolver habilidades essenciais de comunicação e colaboração, como fornecer feedback construtivo, resolver conflitos e trabalhar efetivamente em equipe. + +4. **Retribua à comunidade**: Contribuir para projetos de código aberto é uma maneira de retribuir à comunidade que lhe forneceu conhecimento e recursos valiosos. Compartilhando as suas habilidades e experiência, você pode ajudar a apoiar o crescimento e o sucesso contínuo do movimento de código aberto. + +## Acesso a habilidades + +Contribuir para projetos de código aberto pode ajudá-lo a desenvolver uma ampla gama de habilidades técnicas e não técnicas altamente valorizadas no mercado de trabalho. Como contribuidor de código aberto, você terá a oportunidade de: + +1. **Melhore as suas habilidades de programação**: Trabalhar em projetos reais é uma excelente maneira de melhorar as suas habilidades de programação e aprofundar a sua compreensão de várias tecnologias e linguagens. Ao enfrentar problemas desafiadores e aprender com outros contribuidores, você pode refinar suas habilidades e se tornar um desenvolvedor mais proficiente. + +2. **Adquira experiência com novas tecnologias**: Projetos de código aberto geralmente envolvem tecnologias e ferramentas de ponta que podem não ser usadas no seu trabalho ou estudos diários. Ao contribuir para esses projetos, você pode obter experiência prática com novas tecnologias e ampliar seu conjunto de habilidades. + +3. **Construa o seu portfólio**: Contribuir para projetos de código aberto permite que você crie um registro público do seu trabalho, mostrando as suas habilidades e experiência para potenciais empregadores. Um portfólio forte de contribuições de código aberto pode ajudá-lo a se destacar no mercado de trabalho e demonstrar seu compromisso com a aprendizagem contínua e o crescimento profissional. + +4. **Desenvolva habilidades de resolução de problemas e pensamento crítico**: trabalhar em projetos de código aberto geralmente envolve enfrentar problemas complexos e tomar decisões importantes. Ao navegar nesses desafios, você pode desenvolver habilidades valiosas de resolução de problemas e pensamento crítico que podem ser aplicadas a vários aspectos de sua vida e carreira. + +5. **Aprenda gerenciamento e organização de projetos**: contribuir para projetos de código aberto pode expô-lo a vários aspetos do gerenciamento e organização de projetos, como planejamento, documentação e controle de versão. Ao aprender a gerenciar projetos de código aberto, você pode desenvolver habilidades que podem ser aplicadas a projetos pessoais e profissionais. + +6. **Desenvolva habilidades de liderança e mentoria**: ao ganhar experiência na comunidade de código aberto, você pode se encontrar numa posição para orientar e orientar novos contribuidores. Ao assumir esses papéis de liderança, você pode desenvolver habilidades essenciais, como comunicação, empatia e delegação, que podem ajudá-lo a ter sucesso em sua carreira e vida pessoal. + +## Benefícios adicionais + +Além dos benefícios mencionados acima, contribuir para projetos de código aberto também pode fornecer várias outras vantagens, como: + +1. **Aumento das oportunidades de emprego**: Muitos empregadores valorizam a experiência de código aberto e procuram ativamente candidatos que tenham um histórico comprovado de contribuição para projetos de código aberto. Ao mostrar suas contribuições de código aberto, você pode aumentar suas chances de conseguir o emprego dos seus sonhos ou avançar em sua carreira. + +2. **Crescimento pessoal**: Contribuir para projetos de código aberto pode ser uma experiência gratificante, tanto pessoal quanto profissionalmente. Ao compartilhar suas habilidades e conhecimentos, você pode fazer uma diferença tangível no mundo e contribuir para algo maior que você. + +3. **Oportunidades de reconhecimento**: Projetos de código aberto geralmente atraem a atenção de líderes da indústria, influenciadores e veículos de mídia. Ao fazer contribuições significativas para projetos de alto perfil, você pode ganhar reconhecimento e se estabelecer como um especialista em seu campo. + +No próximo capítulo, discutiremos as ferramentas e recursos essenciais de que você precisará para ter sucesso em sua jornada de código aberto, incluindo GitHub, Git, CodeSee, VS Code e Discord. Ao se familiarizar com essas ferramentas, você estará melhor equipado para colaborar com outras pessoas, gerenciar seus projetos e contribuir efetivamente para projetos de código aberto. + +[Próximo Capítulo -->](./04-tools-to-be-successful.md) \ No newline at end of file diff --git a/translations/pt-br/04-ferramentas-utilizadas.md b/translations/pt-br/04-ferramentas-utilizadas.md new file mode 100644 index 00000000..de4f16ee --- /dev/null +++ b/translations/pt-br/04-ferramentas-utilizadas.md @@ -0,0 +1,138 @@ +# Ferramentas utilizadas + +Para ter sucesso na sua jornada de código aberto, é essencial familiarizar-se com as ferramentas e plataformas comumente utilizadas pela comunidade. Essas ferramentas ajudarão você a colaborar de forma eficaz, gerenciar seus projetos e contribuir para projetos de código aberto. Neste capítulo, discutiremos as seguintes ferramentas essenciais para colaboração de código aberto: + +- GitHub & Git +- CodeSee +- VS Code (O editor) +- Discord + +## Pré-requisitos + +Antes de completar o seguinte passo a passo, complete o seguinte: +- Crie uma [conta no GitHub](https://github.com/) +- Baixe o [VS Code](https://code.visualstudio.com/) + +## GitHub & Git + +### Introdução ao Git + +Git é um sistema de controlo de versão distribuído projetado para lidar com projetos pequenos e muito grandes com velocidade e eficiência. Foi criado por Linus Torvalds, o criador do kernel Linux, para gerir o desenvolvimento do próprio kernel Linux. + +Git permite que os desenvolvedores acompanhem as alterações no seu código, colaborem com outros desenvolvedores e gerenciem várias versões dos seus projetos. Alguns dos recursos principais do Git incluem: + +- **Ramificação**: Git permite que os desenvolvedores criem ramificações, cópias separadas da sua base de código. Isso permite que eles trabalhem em novos recursos ou correções de bugs sem afetar a base de código principal. Uma vez que as alterações estejam concluídas, eles podem mesclar a ramificação de volta para a base de código principal. +- **Área de preparação**: Git fornece uma área de preparação onde os desenvolvedores podem preparar as suas alterações antes de as comprometerem com o repositório. Isso permite que eles revisem e organizem as suas alterações antes de as tornarem permanentes. +- **Controle de versão distribuído**: Ao contrário dos sistemas de controlo de versão centralizados, o Git é um sistema de controlo de versão distribuído. Isso significa que cada desenvolvedor tem uma cópia completa do repositório na máquina local, permitindo-lhes trabalhar offline e independentemente de um servidor central. + +### Introdução ao GitHub + +O GitHub é uma plataforma baseada na web para controlo de versão e colaboração que utiliza o Git como tecnologia subjacente. Ele fornece uma interface simples e amigável para gerir repositórios Git, bem como uma série de recursos e ferramentas para colaborar com outros desenvolvedores. + +Algumas das principais funcionalidades do GitHub incluem: + +- **Rastramento de issues**: O GitHub fornece um sistema integrado de rastreamento de problemas que permite que os desenvolvedores criem, atribuam e gerenciem problemas relacionados aos seus projetos. Os problemas podem ser categorizados usando etiquetas, marcos e pessoas atribuídas, tornando fácil acompanhar o progresso do projeto e priorizar tarefas. +- **Pull requests**: O GitHub introduz o conceito de pedidos de pull, que permitem que os desenvolvedores proponham alterações à base de código de um projeto. Os pedidos de pull permitem a revisão de código, discussão e colaboração antes que as alterações sejam mescladas na base de código principal. +- **Forking**: O GitHub permite que os utilizadores criem uma cópia de um repositório, conhecida como fork. Isso permite que eles façam alterações na base de código sem afetar o projeto original. Uma vez que as alterações estejam concluídas, eles podem enviar um pedido de pull para que as suas alterações sejam revisadas e potencialmente mescladas na base de código principal. +- **GitHub Actions**: O GitHub Actions é uma poderosa ferramenta de automação que permite criar fluxos de trabalho personalizados para automatizar tarefas como a construção, teste e implantação do seu código. + +### Começando com Git e GitHub + +Para começar com Git e GitHub, siga estes passos: + +1. **Instalar o Git**: Baixe e instale o Git no seu computador visitando o site oficial do Git (https://git-scm.com/) e seguindo as instruções de instalação para o seu sistema operacional. +2. **Configurar o Git**: Após instalar o Git, abra um terminal ou prompt de comando e configure as informações do seu usuário Git executando os seguintes comandos: + +```bash +git config --global user.name "Seu nome" +git config --global user.email "seu.email@exemplo.com" +``` + +Substitua "Seu nome" pelo seu nome completo e "seu.email@exemplo.com" pelo endereço de e-mail que você usou para se inscrever no GitHub. + +#### Praticando Contribuições com o VS Code + +Para praticar o uso do GitHub, vamos passar por criar um repositório, clonar o repositório, fazer alterações e empurrar essas alterações. + +1. **Crie um repositório**: Faça login na sua conta do GitHub e navegue até [https://github.com/new](https://github.com/new) ou clique no ícone "+" no canto superior direito e selecione "Novo repositório" no menu suspenso. + +Escollha você mesmo como o proprietário do repositório, e digite um nome para o seu repositório. Para este exemplo, usaremos `practice-repository` + +![new repo screenshot](../../new-repo.png) + +Escollha se você quer que seja público ou privado. Você também pode escolher inicializar o repositório com um arquivo README, um arquivo .gitignore e/ou uma licença. + +Por exemplo, inicialize o repositório com um arquivo README. + +2. **Clone o repositório**: Uma vez que você tenha criado um repositório, você pode cloná-lo para a sua máquina local executando o seguinte comando no seu terminal ou prompt de comando: + +```bash +git clone https://github.com/username/repository-name.git +``` + +Substitua "username" pelo seu nome de utilizador do GitHub e "repository-name" por `practice-repository`. + +3. **Acesse o seu repositório no seu editor de código**: Para este exemplo, estamos usando o VS Code. Abra o VS Code, navegue até a guia de arquivos e abra o seu `practice-repository`. + +4. **Faça alterações e confirme**: Deve haver um arquivo no seu repositório: `README.md`. Dentro desse arquivo, abaixo de `# practice-repository`, digite 'hello world!' Após ter feito alterações, você pode prepará-las e confirmá-las. + +Abra o seu terminal e certifique-se de que está no diretório correto. Por exemplo, os meus projetos de codificação estão dentro da minha pasta `Projects`. Usando o meu terminal, eu acessaria este repositório executando este comando: + +```bash +cd projects/practice-repository +``` + +Agora que você está no diretório correto, use os seguintes comandos para adicionar as alterações que você fez e escrever uma mensagem de confirmação com uma descrição das alterações: + +```bash +git add . +git commit -m "Your commit message" +``` + +Substitua "Your commit message" por uma breve descrição das alterações que você fez. + +5. **Empurre as suas alterações**: Após confirmar as suas alterações, você pode empurrá-las para o seu repositório remoto no GitHub executando o seguinte comando: + +```bash +git push origin main +``` + +O commando `push origen main` empurra as suas alterações para o ramo "main" do seu repositório remoto. Se você quiser verificar o seu trabalho, navegue até o seu repositório do GitHub. Você deve ver 'hello world!' no seu arquivo README.md. + +Você agora configurou com sucesso o Git e o GitHub na sua máquina local e está pronto para colaborar em projetos de código aberto! + +## CodeSee + +CodeSee é uma poderosa ferramenta de visualização que ajuda os desenvolvedores a entenderem bases de código complexas e a navegarem em grandes projetos de forma mais eficiente. Ao fornecer uma representação visual do seu código, o CodeSee permite que você: + +- **Identificar dependências**: O CodeSee ajuda você a entender como diferentes partes da sua base de código estão conectadas e como as alterações numa área podem afetar outras áreas. +- **Analisar a estrutura do código**: O CodeSee permite que você visualize a estrutura do seu código, facilitando identificar padrões, antipadrões e áreas para melhorias. +- **Navegar em grandes bases de código**: com o CodeSee, você pode navegar rapidamente em grandes bases de código e encontrar as partes do código que você precisa trabalhar. + +Para começar com o CodeSee, visite o site oficial (https://www.codesee.io/) e siga as instruções para instalar a extensão do navegador e integrá-la com a sua conta do GitHub.ub account. + +## VS Code + +Visual Studio Code (VS Code) é um editor de código popular, gratuito e de código aberto desenvolvido pela Microsoft. Ele suporta uma ampla gama de linguagens de programação e oferece muitos recursos que o tornam uma ótima escolha para o desenvolvimento de código aberto, incluindo: + +- **Suporte Git integrado**: O VS Code oferece suporte integrado para Git, permitindo que você gerencie os seus repositórios Git, estágio e confirme alterações e resolva conflitos de mesclagem diretamente do editor. +- **Extensibilidade**: O VS Code oferece um rico ecossistema de extensões que podem aprimorar a sua experiência de desenvolvimento e adicionar suporte para idiomas, ferramentas e estruturas adicionais. +- **Terminal integrado**: O VS Code inclui um terminal integrado que permite executar comandos, scripts e tarefas de compilação diretamente do editor. +- **Customizável**: O VS Code é altamente customizável, permitindo que você adapte o editor às suas preferências e fluxo de trabalho. Você pode personalizar o tema, keybindings e configurações para criar um ambiente de desenvolvimento personalizado. + +Para baixar e instalar o VS Code, visite o site oficial (https://code.visualstudio.com/) e siga as instruções para o seu sistema operativo. + +## Discord + +O Discord é uma plataforma popular de mensagens e chat de voz amplamente utilizada por comunidades de código aberto para comunicação e colaboração. Ao juntar-se a servidor Discord relacionados aos seus interesses e projetos, você pode: + +- **Conecte-se com outros desenvolvedores**: O Discord permite que você converse com outros desenvolvedores, faça perguntas e compartilhe o seu conhecimento com a comunidade. +- **Mantenha-se atualizado**: muitos projetos de código aberto usam o Discord para compartilhar atualizações, anúncios e outras informações importantes. Ao juntar-se aos seus servidores, você pode se manter informado sobre os últimos desenvolvimentos e contribuir de forma mais eficaz. +- **Participar de discussões**: Os servidores do Discord muitas vezes hospedam discussões sobre vários tópicos relacionados ao desenvolvimento de código aberto. Ao participar dessas discussões, você pode aprender com os outros, compartilhar as suas ideias e contribuir para o conhecimento coletivo da comunidade. +- **Encontre oportunidades de colaboração**: Os servidores do Discord podem ser um ótimo lugar para encontrar outras pessoas que compartilham os seus interesses e procuram oportunidades de colaboração. Ao fazer networking com outros desenvolvedores, você pode descobrir novos projetos para trabalhar e formar parcerias valiosas. + +Para começar com o Discord, visite o site oficial (https://discord.com/) e inscreva-se para uma conta. Após ter uma conta, você pode procurar por comunidades e projetos de código aberto em plataformas como GitHub, GitLab ou OpenSauced para encontrar os seus servidores do Discord e juntar-se à conversa. + +Familiarizando-se com essas ferramentas e plataformas, você estará equipado para colaborar efetivamente, gerir os seus projetos e contribuir para projetos de código aberto. No próximo capítulo, discutiremos como contribuir para projetos de código aberto, incluindo encontrar projetos para trabalhar, enviar contribuições e o que acontece depois que a sua contribuição é aceite. + +[Próximo Capítulo ->](./05-how-to-contribute-to-open-source.md) \ No newline at end of file diff --git a/translations/pt-br/05-como-contribuir-para-open-source.md b/translations/pt-br/05-como-contribuir-para-open-source.md new file mode 100644 index 00000000..16b4ef51 --- /dev/null +++ b/translations/pt-br/05-como-contribuir-para-open-source.md @@ -0,0 +1,28 @@ +# Como Contribuir Para Open Source + +Neste capítulo, vamos guiá-lo pelo processo de contribuição para projetos de open source. Abordaremos os seguintes tópicos: + +- Encontrar projetos para trabalhar +- Como enviar uma contribuição +- Integração em um novo projeto +- O que acontece depois? + +## Encontrar projetos para trabalhar + +Um dos primeiros desafios que você pode enfrentar ao começar com o código +aberto é encontrar um projeto para o qual contribuir. +Aqui estão algumas dicas para ajudá-lo a descobrir projetos que se alinham com seus interesses e habilidades: + +1. **Navegue no GitHub e no GitLab**: Tanto o GitHub quanto o GitLab hospedam um grande número de projetos de open source. +Você pode usar a funcionalidade de pesquisa para encontrar projetos com base em palavras-chave, linguagens de programação ou tópicos específicos. + +2. **Siga seus interesses**: Pense nas ferramentas, estruturas e bibliotecas que você usa ou sobre as quais tem interesse em aprender mais. Muitos desses projetos são de open source e recebem contribuições da comunidade. + +3. **Junte-se a comunidades de código aberto**: Existem várias comunidades on-line, fóruns e plataformas de bate-papo dedicadas ao desenvolvimento de open source. +Ao ingressar nessas comunidades, você pode se conectar com outros desenvolvedores, descobrir novos projetos e encontrar oportunidades de colaboração. +No [Discord do OpenSauced](https://discord.com/invite/U2peSNf23P), por exemplo, compartilhamos bons primeiros problemas, projetos legais do GitHub e problemas que abrimos em nossos repositórios. + +4. **Aproveite o OpenSauced**: [OpenSauced](https://opensauced.pizza/) é uma plataforma que ajuda os desenvolvedores a descobrir e contribuir com projetos de open source. +Ao usar o OpenSauced, você pode encontrar projetos alinhados com seus interesses, habilidades e objetivos. + +[Próximo Capítulo ->](./06-the-secret-sauce.md) \ No newline at end of file diff --git a/translations/pt-br/06-o-molho-secreto.md b/translations/pt-br/06-o-molho-secreto.md new file mode 100644 index 00000000..6021d4cd --- /dev/null +++ b/translations/pt-br/06-o-molho-secreto.md @@ -0,0 +1,81 @@ +# O Molho Secreto + + +Neste capítulo, vamos compartilhar algumas estratégias e dicas menos conhecidas para causar um impacto duradouro na comunidade de código aberto. Discutiremos como focar em issues abertos, ganhar tração em suas contribuições e desenvolver seu currículo de código aberto usando o OpenSauced. + +## Isues abertos, mais do que PRs que corrigem erros de digitação + + +Enquanto corrigir erros de digitação e melhorar a documentação são contribuições valiosas para projetos de código aberto, é essencial olhar além desses frutos de baixo nível e focar na resolução de issues abertos. Abordar issues abertos não apenas ajuda o projeto a avançar, mas também permite que você desenvolva uma compreensão mais profunda da base de código e demonstre suas habilidades de resolução de issues. + +Aqui estão algumas dicas para encontrar e resolver abrir issues: + + +1. **Navegue no rastreador de issues**: A maioria dos projetos de código aberto usa um rastreador de issues para gerenciar bugs, solicitações de recursos e outras tarefas. Navegue no rastreador de issues para encontrar issues que se alinhem com seus interesses e habilidades. + +2. **Procure por issues amigáveis para iniciantes**: Muitos projetos usam rótulos como "bom primeiro issue" ou "ajuda desejada" para indicar issues que são adequados para iniciantes. Comece com esses issues para construir sua confiança e ganhar experiência antes de abordar tarefas mais complexas. + +3. **Entenda a issue**: Antes de mergulhar em uma issue, certifique-se de entender o problema e o resultado desejado. Se você não tiver certeza de algo, faça perguntas ou peça esclarecimentos aos mantenedores do projeto ou a outros colaboradores. + +4. **Comunique suas intenções**: Antes de começar a trabalhar em uma issue, informe aos mantenedores do projeto e a outros colaboradores que você está interessado em abordá-la. Isso pode ajudar a evitar esforços duplicados e garantir que todos estejam na mesma página. + +5. **Teste suas alterações**: Depois de abordar uma issue, teste suas alterações minuciosamente para garantir que funcionem conforme o esperado e não introduzam novos problemas. + +Ao se concentrar em issues abertas em vez de apenas corrigir erros de digitação, você terá um impacto maior nos projetos aos quais contribui e demonstrará seu compromisso com a comunidade de código aberto. + +## Ganhar tração em suas contribuições + +Enquanto você ganha mais experiência em contribuições de código aberto, pode querer aumentar seu impacto nos projetos em que trabalha e ganhar reconhecimento por seus esforços. Aqui estão algumas estratégias para ganhar tração em suas contribuições: + +1. **Torne-se um colaborador regular**: Contribua consistentemente para os mesmos projetos ao longo do tempo. Isso ajudará você a desenvolver uma compreensão mais profunda da base de código, construir relacionamentos com outros colaboradores e se estabelecer como um membro valioso da comunidade. + +2. **Assuma tarefas desafiadoras**: À medida que você ganha experiência, aborde issues e recursos mais complexos. Isso não apenas ajudará você a crescer como desenvolvedor, mas também demonstrará sua capacidade de lidar com tarefas desafiadoras e contribuir significativamente para o projeto. + +3. **Colabore com os outros**: O código aberto é tudo sobre colaboração. Trabalhe com outros colaboradores para resolver issues, desenvolver recursos e compartilhar conhecimento. Ao colaborar efetivamente, você não apenas melhorará o projeto, mas também construirá uma forte rede de conexões na comunidade de código aberto. + +4. **Compartilhe seu conhecimento**: Compartilhe seu conhecimento e insights escrevendo postagens de blog, criando tutoriais ou dando apresentações sobre os projetos em que trabalha. Isso não apenas ajudará os outros a aprender com suas experiências, mas também o estabelecerá como um líder de pensamento na comunidade de código aberto. + + +5. **Mentore novos colaboradores**: À medida que você ganha mais experiência em contribuições de código aberto, considere orientar novos colaboradores que estão começando sua jornada de código aberto. Isso pode ajudá-lo a retribuir à comunidade, desenvolver suas habilidades de liderança e construir uma reputação positiva. + +## Desenvolva seu currículo de código aberto + +Construir um currículo de código aberto forte pode ajudá-lo a demonstrar suas habilidades, experiência e contribuições para potenciais empregadores, colaboradores e a comunidade de desenvolvedores em geral. O OpenSauced é uma excelente ferramenta para rastrear suas contribuições de código aberto e desenvolver seu currículo de código aberto. Vamos ver como você pode usar o OpenSauced para apoiar sua jornada de código aberto. + +1. **Inscreva-se em uma conta OpenSauced**: se você ainda não criou uma conta, visite [opensauced.pizza](https://opensauced.pizza/) e inscreva-se em uma conta usando suas credenciais do GitHub. + +2. **Visite sua página de perfil público**: Depois de se inscrever, uma página de perfil público será criada para você. Esta página exibirá suas informações de perfil do GitHub e uma lista de suas contribuições de código aberto. Você pode navegar até ela clicando em seu nome de usuário no canto superior direito da página. + +3. **Construa seu currículo de código aberto**: A partir daqui, você poderá adicionar destaques a Pull Requests e Issues que você contribuiu. Você também pode adicionar uma descrição e links ao seu currículo de código aberto. Eles serão agregados em uma única página que você pode compartilhar com outras pessoas, bem como um resumo de suas contribuições que será exibido em sua página de perfil público. + +Vamos mostrar nossa contribuição para o guestbook do capítulo anterior! Em seu perfil, você verá uma seção "Destaques" com uma entrada de texto. Quando você clica nisso, você pode adicionar um título, alguns pensamentos e um link para o seu PR. Isso será exibido em sua página de perfil público. Vamos adicionar um destaque para nossa contribuição para o guestbook. + +## Destacar efetivamente suas contribuições + +Informações importantes a serem incluídas ao destacar suas contribuições: + +- Novo material que você criou; +- Detalhes do projeto (ferramentas, bibliotecas, tamanho e complexidade); +- O tipo de suas contribuições: correção de bugs, recurso, desempenho, documentação, etc.; +- Os detalhes de sua contribuição, incluindo melhorias e impactos feitos no projeto e na comunidade; +- Detalhes de colaboração e trabalho em equipe; + +### Formatar seu destaque + +Para ser mais eficaz ao destacar suas contribuições, recomendamos o uso do seguinte formato: + +- **Título**: Este deve ser uma breve descrição da contribuição. Por exemplo, "Criei uma ação do GitHub para mesclar automaticamente pull requests". +- **Link** +- **Descrição**: quando você destaca sua contribuição, recomendamos mencionar o impacto que ela teve no projeto geral. Isso seria útil para destacar suas qualificações para cargos de emprego, especialmente se você tiver lacunas de emprego. Considere usar o seguinte modelo para ajudá-lo a transformar esse destaque em uma história: + - Verbo de sucesso + substantivo + métrica + resultado. + - Exemplo: Enquanto eu estava revisando alguns pull requests para o GirlScript Summer of Code deste ano, notei que a maioria deles não seria mesclada, apesar de eu e o proprietário darmos aprovações. Então, **criei uma ação do GitHub onde os pull requests são mesclados automaticamente assim que passam pelas etapas de implantação (verbo + substantivo sucessivo)**, o que **aumentou as taxas de produtividade em 80% (métrica + resultado).** + +![Adicionando um destaque ao seu perfil](../../opensauced-highlights.png) + +**Compartilhe!**: Depois de construir um portfólio de contribuições de código aberto, você pode compartilhar seu currículo de código aberto com outras pessoas clicando no botão de compartilhamento no cabeçalho de sua página de perfil. Isso pode ser especialmente útil ao se candidatar a empregos, fazer networking com outros desenvolvedores ou promover seu trabalho na comunidade de código aberto. + +Ao alavancar o OpenSauced para rastrear suas contribuições de código aberto e desenvolver seu currículo, você estará mais bem equipado para mostrar suas habilidades, experiência e impacto na comunidade de código aberto. + +Para concluir, começar a contribuir para o código aberto e causar um impacto duradouro nos projetos em que você trabalha requer uma combinação de habilidades técnicas, colaboração e persistência. Ao se concentrar em issues abertas, ganhar tração em suas contribuições e alavancar ferramentas como OpenSauced, você estará bem encaminhado para uma jornada de código aberto bem-sucedida e gratificante. + +[Último Capítulo ->](./07-conclusion.md) diff --git "a/translations/pt-br/07-conclus\303\243o.md" "b/translations/pt-br/07-conclus\303\243o.md" new file mode 100644 index 00000000..da4a5aed --- /dev/null +++ "b/translations/pt-br/07-conclus\303\243o.md" @@ -0,0 +1,39 @@ +# Conclusão + +Como concluímos este curso sobre como começar com open source, vamos recapitular as principais conclusões e discutir o que vem a seguir em sua jornada de open source. + +## Considerações gerais + +Ao longo deste curso, cobrimos uma variedade de tópicos projetados para ajudá-lo a entender e navegar pelo mundo do open source: + +1. **O que é open source?**: Discutimos a definição de open source, sua história e os princípios básicos que orientam o movimento open source. + +2. **Por que open source?**: Exploramos os benefícios de se envolver com projetos de open source, incluindo acesso ao conhecimento, comunidade e desenvolvimento de habilidades. + +3. **Ferramentas para ter sucesso**: Apresentamos ferramentas e plataformas essenciais para colaboradores de open source, como GitHub, Git, CodeSee, Visual Studio Code e Discord. + +4. **Como contribuir para open source**: Discutimos o processo de encontrar projetos para trabalhar, enviar contribuições, embarcar em novos projetos e o que acontece depois que sua contribuição é enviada. + +5. **O segredo do sauce**: Compartilhamos estratégias para começar com contribuições de open source, ganhar tração em suas contribuições e desenvolver seu currículo de open source usando o OpenSauced. + +Ao entender esses conceitos e aplicar as estratégias que discutimos, você estará bem equipado para embarcar em uma jornada de open source bem-sucedida. + +# O que vem a seguir? + +Com o conhecimento e as ferramentas que você adquiriu neste curso, você está pronto para mergulhar no mundo do open source e começar a fazer contribuições significativas. Aqui estão alguns próximos passos para ajudá-lo a continuar sua jornada de open source: + +1. **Identifique seus interesses e objetivos**: Antes de começar a contribuir para projetos de open source, reserve um tempo para pensar em seus interesses, paixões e objetivos. Isso ajudará você a identificar projetos que se alinham com seus valores e objetivos. + +2. **Encontre projetos para contribuir**: Use plataformas como GitHub, OpenSauced e CodeTriage para descobrir projetos de open source que se alinham com seus interesses e habilidades. Procure projetos com comunidades ativas, documentação clara e diretrizes de contribuição bem definidas. + +3. **Comece a contribuir**: Depois de identificar um projeto para contribuir, comece abordando tarefas pequenas e gerenciáveis para construir sua confiança e ganhar experiência. À medida que você se sentir mais confortável, assuma tarefas e desafios mais complexos. + +4. **Conecte-se com a comunidade de open source**: Junte-se a fóruns on-line, plataformas de bate-papo e grupos de mídia social relacionados aos projetos que você está interessado. Interaja com outros colaboradores, faça perguntas e compartilhe seu conhecimento. + +5. **Participe de eventos e conferências**: Participe de eventos, conferências e encontros de open source para aprender com os outros, fazer networking com outros desenvolvedores e se manter atualizado sobre as últimas tendências e melhores práticas no mundo do open source. + +6. **Compartilhe suas experiências**: Documente sua jornada de open source escrevendo postagens de blog, criando tutoriais ou dando apresentações. Isso não apenas ajudará os outros a aprender com suas experiências, mas também o estabelecerá como um líder de pensamento na comunidade de open source. + +7. **Continue aprendendo**: O open source é um campo dinâmico e em constante evolução. Mantenha-se atualizado com as últimas ferramentas, técnicas e melhores práticas participando de workshops, fazendo cursos on-line e lendo artigos e livros sobre desenvolvimento de open source. Incluímos uma [seção de recursos adicionais](./08-additional-resources.md) para obter mais informações. + +Em conclusão, embarcar em uma jornada de open source é uma experiência gratificante e enriquecedora que pode ajudá-lo a desenvolver novas habilidades, se conectar com pessoas de mentalidade semelhante e ter um impacto duradouro nos projetos em que trabalha. Com o conhecimento e as ferramentas que você adquiriu neste curso, você está bem preparado para enfrentar os desafios e oportunidades emocionantes que o aguardam no mundo do open source. Então vá em frente e comece a contribuir - a comunidade de open source aguarda ansiosamente sua participação! \ No newline at end of file diff --git a/translations/pt-br/08-recursos-adicionais.md b/translations/pt-br/08-recursos-adicionais.md new file mode 100644 index 00000000..5ff6e1c0 --- /dev/null +++ b/translations/pt-br/08-recursos-adicionais.md @@ -0,0 +1,25 @@ +Felicitações por sua jornada no open source! Aqui estão alguns recursos para aprender mais sobre como começar no open source:source: + +## Guias e Tutoriais + +- [Open Source Guides](https://opensource.guide/) por GitHub: Guias abrangentes sobre vários aspectos do open source, incluindo como começar, contribuir, manter projetos e construir comunidades. + +- [Primeira Contribuição](https://github.com/firstcontributions/first-contributions) por Roshan Jossey: Um guia para iniciantes que o guia por sua primeira contribuição para um projeto de código aberto. + +- [Guia para iniciantes em Desenvolvimento de Software Open Source](https://training.linuxfoundation.org/training/beginners-guide-open-source-software-development/) por The Linux Foundation: Um curso online gratuito que aborda os conceitos básicos do open source, incluindo sua história, licenças e modelos de desenvolvimento. + +- [Mozilla's Open Source Student Network (OSSN)](https://community.mozilla.org/en/): Fornece recursos e suporte para estudantes interessados em open source, incluindo guias, eventos e oportunidades de mentoria. + +- [Introdução ao GitHub e projetos Open Source](https://www.digitalocean.com/community/tutorial_series/an-introduction-to-open-source) por DigitalOcean: Uma série de tutoriais para iniciantes que aborda os conceitos básicos do open source, incluindo como encontrar projetos para contribuir, entender o código e enviar contribuições. + +- [Open Source Friday](https://opensourcefriday.com/) por GitHub: Um movimento global que incentiva indivíduos e organizações a contribuir para o open source todas as sextas-feiras. O site fornece recursos e guias sobre como começar no open source e encontrar projetos para contribuir. + +## Blog posts + +- [Além da Criação de Conteúdo: Como as Contribuições de Open Source Podem Ajudá-lo a Ser Notado](https://dev.to/opensauced/beyond-content-creation-how-open-source-contributions-can-help-you-get-noticed-4l5n) + +- [Escrevendo sua primeira Pull Request: Dicas, Melhores Práticas e Ferramentas com Inteligência Artificial para o Sucesso](https://dev.to/opensauced/writing-your-first-pull-request-tips-best-practices-and-ai-powered-tools-for-success-3bg9) + +- [Como Contribuir para Open Source sem Saber Programar: Um guia com sugestões de projetos](https://dev.to/opensauced/how-to-contribute-to-open-source-without-knowing-how-to-code-a-guide-with-project-suggestions-59e5) + +- [Como Escrever uma Boa Issue: Dicas para Comunicação Eficaz em Open Source](https://dev.to/opensauced/how-to-write-a-good-issue-tips-for-effective-communication-in-open-source-5443) \ No newline at end of file diff --git "a/translations/pt-br/09-gloss\303\241rio.md" "b/translations/pt-br/09-gloss\303\241rio.md" new file mode 100644 index 00000000..9b14d18c --- /dev/null +++ "b/translations/pt-br/09-gloss\303\241rio.md" @@ -0,0 +1,88 @@ +## Repositório + +Um repositório é um local central onde o código é armazenado e gerenciado. Em open source, os repositórios geralmente são hospedados em plataformas como GitHub, GitLab ou Bitbucket. Cada repositório pode conter um ou mais projetos, e os contribuidores podem enviar alterações no código fazendo solicitações pull. + +## Mantenedor + +Um mantenedor é uma pessoa ou um grupo de pessoas responsável por manter um projeto de open source específico. Os mantenedores são normalmente responsáveis ​​por revisar e aceitar ou rejeitar as contribuições de outros contribuidores. Eles também têm autoridade para tomar as decisões finais sobre a direção e o escopo do projeto. + +## Membro Principal + +Um membro principal é um colaborador que recebeu privilégios ou responsabilidades adicionais em um projeto de open source. Os membros principais geralmente são colaboradores confiáveis ​​que demonstraram um profundo conhecimento do projeto e fizeram contribuições significativas para o seu desenvolvimento. + +## Emitir + +Um problema é um problema ou bug que precisa ser resolvido no código. Os problemas podem ser criados por qualquer pessoa e geralmente são usados ​​para rastrear bugs, solicitações de recursos e outras tarefas que precisam ser executadas. + +# Contribuidor + +Um colaborador é qualquer pessoa que faz alterações, acréscimos ou sugestões a um projeto de open source. Os colaboradores podem ser desenvolvedores, designers, escritores, testadores ou qualquer outra pessoa que ajude a tornar o projeto melhor. + +## Clonar + +A clonagem é o processo usado para copiar um repositório Git existente para um novo diretório local. O comando `git clone` criará um novo diretório local para o repositório, copiará todo o conteúdo do repositório especificado, criará os branches rastreados remotos e fará o checkout de um branch inicial localmente. Por padrão, o clone do Git criará uma referência ao repositório remoto chamado origin. + +## Garfo + +Uma bifurcação é uma cópia de um repositório. Ao bifurcar um repositório, você cria uma nova cópia da base de código que pode modificar e experimentar sem afetar a base de código original. + +## Filial + +Uma ramificação é uma versão separada do código criada para fins de desenvolvimento. As ramificações permitem que os contribuidores experimentem as alterações sem afetar a base de código principal. Quando as alterações estão prontas para serem mescladas na base de código principal, elas geralmente são enviadas como uma pull request. + +## Solicitação de pull + +Uma solicitação pull é uma solicitação de um contribuidor a um mantenedor para que as alterações feitas no código sejam inseridas em uma base de código. + +## Mesclar + +Mesclar é o processo de combinar alterações de uma ramificação em outra. Quando uma solicitação pull é aceita e mesclada, as alterações feitas na solicitação pull tornam-se parte da base de código principal. + +## Documentos + +Esta é uma abreviação da palavra documentação, um pedaço de texto que fornece informações sobre como contribuir para projetos OSS e expectativas para contribuidores. Markdown, uma linguagem de codificação baseada em texto, é frequentemente usada para criar essas formas de conteúdo. Quer ver um em ação? Confira o [Guia de estilo em nosso repositório Pizza Verse](https://github.com/open-sauced/pizza-verse/blob/main/style-guide.md)! +Esta é uma abr## Repositório + +Um repositório é um local central onde o código é armazenado e gerenciado. Em open source, os repositórios geralmente são hospedados em plataformas como GitHub, GitLab ou Bitbucket. Cada repositório pode conter um ou mais projetos, e os contribuidores podem enviar alterações no código fazendo solicitações pull. + +## Mantenedor + +Um mantenedor é uma pessoa ou um grupo de pessoas responsável por manter um projeto de open source específico. Os mantenedores são normalmente responsáveis ​​por revisar e aceitar ou rejeitar as contribuições de outros contribuidores. Eles também têm autoridade para tomar as decisões finais sobre a direção e o escopo do projeto. + +## Membro Principal + +Um membro principal é um colaborador que recebeu privilégios ou responsabilidades adicionais em um projeto de open source. Os membros principais geralmente são colaboradores confiáveis ​​que demonstraram um profundo conhecimento do projeto e fizeram contribuições significativas para o seu desenvolvimento. + +## Emitir + +Um problema é um problema ou bug que precisa ser resolvido no código. Os problemas podem ser criados por qualquer pessoa e geralmente são usados ​​para rastrear bugs, solicitações de recursos e outras tarefas que precisam ser executadas. + +# Contribuidor + +Um colaborador é qualquer pessoa que faz alterações, acréscimos ou sugestões a um projeto de open source. Os colaboradores podem ser desenvolvedores, designers, escritores, testadores ou qualquer outra pessoa que ajude a tornar o projeto melhor. + +## Clonar + +A clonagem é o processo usado para copiar um repositório Git existente para um novo diretório local. O comando `git clone` criará um novo diretório local para o repositório, copiará todo o conteúdo do repositório especificado, criará os branches rastreados remotos e fará o checkout de um branch inicial localmente. Por padrão, o clone do Git criará uma referência ao repositório remoto chamado origin. + +## Garfo + +Uma bifurcação é uma cópia de um repositório. Ao bifurcar um repositório, você cria uma nova cópia da base de código que pode modificar e experimentar sem afetar a base de código original. + +## Filial + +Uma ramificação é uma versão separada do código criada para fins de desenvolvimento. As ramificações permitem que os contribuidores experimentem as alterações sem afetar a base de código principal. Quando as alterações estão prontas para serem mescladas na base de código principal, elas geralmente são enviadas como uma pull request. + +## Solicitação de pull + +Uma solicitação pull é uma solicitação de um contribuidor a um mantenedor para que as alterações feitas no código sejam inseridas em uma base de código. + +## Mesclar + +Mesclar é o processo de combinar alterações de uma ramificação em outra. Quando uma solicitação pull é aceita e mesclada, as alterações feitas na solicitação pull tornam-se parte da base de código principal. + +## Documentos + +Isso é uma abreviação da palavra "documentação", um pedaço de texto que fornece informações sobre como contribuir para projetos de código aberto e expectativas para os contribuidores. +O Markdown, uma linguagem de codificação baseada em texto, é frequentemente usado para criar esse tipo de conteúdo. +Quer ver um exemplo em ação? Confira o [Guia de Estilo no nosso repositório Pizza Verse](https://github.com/open-sauced/pizza-verse/blob/main/style-guide.md)! From 53ed47b97f17b33ac847e1e35c67722503cb4b02 Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Tue, 19 Sep 2023 20:12:22 -0400 Subject: [PATCH 03/62] fix: made some edits --- .../pt-br/01-introdu\303\247\303\243o.md" | 52 +++---- .../pt-br/02-o-que-\303\251-open-source.md" | 69 --------- translations/pt-br/03-por-que-open-source.md | 57 -------- .../pt-br/04-ferramentas-utilizadas.md | 138 ------------------ .../05-como-contribuir-para-open-source.md | 28 ---- ...ho-secreto.md => 06-o-segredo-do sauce.md} | 2 +- "translations/pt-br/07-conclus\303\243o.md" | 39 ----- translations/pt-br/08-recursos-adicionais.md | 25 ---- "translations/pt-br/09-gloss\303\241rio.md" | 88 ----------- translations/pt-br/README.pt.md | 53 +++++++ translations/pt-br/sidebar.md | 10 -- 11 files changed, 80 insertions(+), 481 deletions(-) delete mode 100644 "translations/pt-br/02-o-que-\303\251-open-source.md" delete mode 100644 translations/pt-br/03-por-que-open-source.md delete mode 100644 translations/pt-br/04-ferramentas-utilizadas.md delete mode 100644 translations/pt-br/05-como-contribuir-para-open-source.md rename translations/pt-br/{06-o-molho-secreto.md => 06-o-segredo-do sauce.md} (99%) delete mode 100644 "translations/pt-br/07-conclus\303\243o.md" delete mode 100644 translations/pt-br/08-recursos-adicionais.md delete mode 100644 "translations/pt-br/09-gloss\303\241rio.md" create mode 100644 translations/pt-br/README.pt.md delete mode 100644 translations/pt-br/sidebar.md diff --git "a/translations/pt-br/01-introdu\303\247\303\243o.md" "b/translations/pt-br/01-introdu\303\247\303\243o.md" index 13f47212..bf8b3a8c 100644 --- "a/translations/pt-br/01-introdu\303\247\303\243o.md" +++ "b/translations/pt-br/01-introdu\303\247\303\243o.md" @@ -2,7 +2,7 @@ Bem-vindo ao curso "Getting Started with Open Source"! Este curso abrangente irá guiá-lo pelo fascinante mundo do open source e ajudá-lo a se tornar um colaborador ativo. -Ao final deste curso, você deve ter uma compreensão sólida de como encontrar, participar e contribuir para projetos de código aberto, bem como como desenvolver seu currículo de código aberto. +Ao final deste curso, você deve ter uma compreensão sólida de como encontrar, participar e contribuir para projetos de open source, bem como como desenvolver seu currículo de open source. Mas primeiro, vamos preparar o cenário discutindo os pré-requisitos, objetivos e expectativas para este curso. ## Pré-requisitos @@ -19,49 +19,49 @@ Se você ainda não está familiarizado com o Git e o GitHub, recomendamos que v Ao longo deste curso, nossos principais objetivos são ajudá-lo a: -1. **Entender o código aberto e seus benefícios**: exploraremos o conceito de código aberto, sua história e as inúmeras vantagens de contribuir para projetos de código aberto. -2. **Aprenda a encontrar projetos de código aberto**: descobrir projetos que se alinham com seus interesses e habilidades é crucial para uma experiência de código aberto gratificante. Apresentaremos a você ferramentas e técnicas para encontrar projetos para contribuir. -3. **Dominar as ferramentas e processos para contribuir**: forneceremos uma visão geral das ferramentas e processos essenciais para uma colaboração de código aberto bem-sucedida, como controle de versão, revisão de código e plataformas de comunicação. -4. **Adquira experiência prática**: seguindo exemplos e demonstrações, você terá a oportunidade de praticar suas habilidades e ganhar confiança em sua capacidade de contribuir para projetos de código aberto. -5. **Desenvolva seu currículo de código aberto**: mostrar suas contribuições de código aberto é vital para construir sua reputação na comunidade e demonstrar sua experiência para potenciais empregadores ou clientes. Discutiremos estratégias para desenvolver e manter seu currículo de código aberto. +1. **Entender o open source e seus benefícios**: exploraremos o conceito de open source, sua história e as inúmeras vantagens de contribuir para projetos de open source. +2. **Aprenda a encontrar projetos de open source**: descobrir projetos que se alinham com seus interesses e habilidades é crucial para uma experiência de open source gratificante. Apresentaremos a você ferramentas e técnicas para encontrar projetos para contribuir. +3. **Dominar as ferramentas e processos para contribuir**: forneceremos uma visão geral das ferramentas e processos essenciais para uma colaboração de open source bem-sucedida, como controle de versão, revisão de código e plataformas de comunicação. +4. **Adquira experiência prática**: seguindo exemplos e demonstrações, você terá a oportunidade de praticar suas habilidades e ganhar confiança em sua capacidade de contribuir para projetos de open source. +5. **Desenvolva seu currículo de open source**: mostrar suas contribuições de open source é vital para construir sua reputação na comunidade e demonstrar sua experiência para potenciais empregadores ou clientes. Discutiremos estratégias para desenvolver e manter seu currículo de open source. ## Expectativas -Este curso foi projetado para fornecer uma base sólida em colaboração de código aberto. +Este curso foi projetado para fornecer uma base sólida em colaboração de open source. Embora cubramos uma variedade de tópicos e forneçamos exemplos, demonstrações e oportunidades para prática, é essencial ter expectativas realistas sobre o que você pode alcançar durante o curso. -1. **A prática é crucial**: aprender sobre código aberto é apenas o começo; para se tornar um colaborador proficiente, você precisará praticar consistentemente. -Tenha em mente que quanto mais você contribuir para projetos de código aberto, mais aprenderá e crescerá como desenvolvedor. +1. **A prática é crucial**: aprender sobre open source é apenas o começo; para se tornar um colaborador proficiente, você precisará praticar consistentemente. +Tenha em mente que quanto mais você contribuir para projetos de open source, mais aprenderá e crescerá como desenvolvedor. -2. **A paciência é fundamental**: tornar-se proficiente em colaboração de código aberto leva tempo e esforço. Não se desanime se encontrar desafios ao longo do caminho; lembre-se de que toda contribuição, por menor que seja, é valiosa e ajuda a melhorar o projeto. +2. **A paciência é fundamental**: tornar-se proficiente em colaboração de open source leva tempo e esforço. Não se desanime se encontrar desafios ao longo do caminho; lembre-se de que toda contribuição, por menor que seja, é valiosa e ajuda a melhorar o projeto. -3. **Engajamento com a comunidade**: o código aberto é mais do que apenas código; trata-se das pessoas que colaboram e contribuem para projetos. Engaje-se com a comunidade fazendo perguntas, compartilhando seu conhecimento e apoiando os outros. -Construir relacionamentos com outros colaboradores aprimorará sua experiência de código aberto e ajudará você a crescer como desenvolvedor. +3. **Engajamento com a comunidade**: o open source é mais do que apenas código; trata-se das pessoas que colaboram e contribuem para projetos. Engaje-se com a comunidade fazendo perguntas, compartilhando seu conhecimento e apoiando os outros. +Construir relacionamentos com outros colaboradores aprimorará sua experiência de open source e ajudará você a crescer como desenvolvedor. -4. **Aprendizado contínuo**: o código aberto é um campo em rápida evolução, com novos projetos, ferramentas e tecnologias surgindo o tempo todo. Mantenha-se curioso e aberto para aprender, e aproveite os recursos, como documentação, tutoriais e fóruns da comunidade, para expandir seus conhecimentos e se manter atualizado com os últimos desenvolvimentos. +4. **Aprendizado contínuo**: o open source é um campo em rápida evolução, com novos projetos, ferramentas e tecnologias surgindo o tempo todo. Mantenha-se curioso e aberto para aprender, e aproveite os recursos, como documentação, tutoriais e fóruns da comunidade, para expandir seus conhecimentos e se manter atualizado com os últimos desenvolvimentos. -5. **Desenvolvendo uma mentalidade de crescimento**: abrace os desafios e oportunidades que surgem com a colaboração de código aberto. Adote uma mentalidade de crescimento, que se concentra em aprendizado, melhoria e resiliência. Ao ver os obstáculos como oportunidades de crescimento, você estará mais bem equipado para navegar no complexo mundo do código aberto e alcançar o sucesso em suas contribuições. +5. **Desenvolvendo uma mentalidade de crescimento**: abrace os desafios e oportunidades que surgem com a colaboração de open source. Adote uma mentalidade de crescimento, que se concentra em aprendizado, melhoria e resiliência. Ao ver os obstáculos como oportunidades de crescimento, você estará mais bem equipado para navegar no complexo mundo do open source e alcançar o sucesso em suas contribuições. ## Estrutura do curso -Este curso é dividido em vários capítulos, cada um projetado para cobrir um aspecto específico da colaboração de código aberto: +Este curso é dividido em vários capítulos, cada um projetado para cobrir um aspecto específico da colaboração de open source: -1. **Introdução:** Começaremos preparando o cenário para sua jornada de código aberto, discutindo pré-requisitos, objetivos e expectativas. -2. **O que é código aberto?:** Neste capítulo, exploraremos a definição de código aberto e sua história, fornecendo uma base sólida para entender o contexto da colaboração de código aberto. -3. **Por que código aberto?:** Vamos mergulhar nos benefícios do código aberto, incluindo acesso ao conhecimento, comunidade e desenvolvimento de habilidades. -4. **Ferramentas para ter sucesso:** Este capítulo apresentará as ferramentas essenciais para uma colaboração de código aberto bem-sucedida, incluindo GitHub, Git, CodeSee, VS Code e Discord. -5. **Como contribuir para o código aberto:** Neste capítulo, discutiremos o processo de encontrar projetos para trabalhar, enviar contribuições, embarcar em um novo projeto e o que esperar depois que sua contribuição for enviada. -6. **The Secret Sauce:** Este capítulo revelará as estratégias e técnicas para começar, ganhar tração em suas contribuições, -7. **Conclusão:** Encerraremos o curso com as principais conclusões e discutiremos os próximos passos em sua jornada de código aberto. +1. **Introdução:** Começaremos preparando o cenário para sua jornada de open source, discutindo pré-requisitos, objetivos e expectativas. +2. **O que é open source?:** Neste capítulo, exploraremos a definição de open source e sua história, fornecendo uma base sólida para entender o contexto da colaboração de open source. +3. **Por que open source?:** Vamos mergulhar nos benefícios do open source, incluindo acesso ao conhecimento, comunidade e desenvolvimento de habilidades. +4. **Ferramentas para ter sucesso:** Este capítulo apresentará as ferramentas essenciais para uma colaboração de open source bem-sucedida, incluindo GitHub, Git, CodeSee, VS Code e Discord. +5. **Como contribuir para o open source:** Neste capítulo, discutiremos o processo de encontrar projetos para trabalhar, enviar contribuições, embarcar em um novo projeto e o que esperar depois que sua contribuição for enviada. +6. **O segredo do sauce:** Este capítulo revelará as estratégias e técnicas para começar, ganhar tração em suas contribuições, +7. **Conclusão:** Encerraremos o curso com as principais conclusões e discutiremos os próximos passos em sua jornada de open source. -Ao longo deste curso, forneceremos exemplos e demonstrações para ajudar a ilustrar conceitos-chave e fornecer oportunidades práticas de prática. Quando possível, apresentaremos projetos e ferramentas de código aberto do mundo real, como [OpenSauced](https://opensauced.pizza/), para demonstrar como aplicar as habilidades que você aprendeu. +Ao longo deste curso, forneceremos exemplos e demonstrações para ajudar a ilustrar conceitos-chave e fornecer oportunidades práticas de prática. Quando possível, apresentaremos projetos e ferramentas de open source do mundo real, como [OpenSauced](https://opensauced.pizza/), para demonstrar como aplicar as habilidades que você aprendeu. -Por favor, note que enquanto esses exemplos e demonstrações são projetados para fornecer orientação e inspiração, sua própria jornada de código aberto pode ser diferente, dependendo de seus interesses, habilidades e projetos escolhidos. +Por favor, note que enquanto esses exemplos e demonstrações são projetados para fornecer orientação e inspiração, sua própria jornada de open source pode ser diferente, dependendo de seus interesses, habilidades e projetos escolhidos. -Use os exemplos e demos como ponto de partida, mas não tenha medo de explorar outros projetos, ferramentas e recursos à medida que você continua a aprender e crescer. +Usar os exemplos e demos como ponto de partida, mas não tenha medo de explorar outros projetos, ferramentas e recursos à medida que você continua a aprender e crescer. ## LFG 🚀 -Agora que nos apresentamos, é hora de embarcar em sua jornada de código aberto! No próximo capítulo, mergulharemos na definição de código aberto e exploraremos sua história, preparando o cenário para uma compreensão mais profunda da colaboração de código aberto. Vamos começar! +Agora que nos apresentamos, é hora de embarcar em sua jornada de open source! No próximo capítulo, mergulharemos na definição de open source e exploraremos sua história, preparando o cenário para uma compreensão mais profunda da colaboração de open source. Vamos começar! [Próximo Capítulo ->](./02-what-is-open-source.md) \ No newline at end of file diff --git "a/translations/pt-br/02-o-que-\303\251-open-source.md" "b/translations/pt-br/02-o-que-\303\251-open-source.md" deleted file mode 100644 index 847766eb..00000000 --- "a/translations/pt-br/02-o-que-\303\251-open-source.md" +++ /dev/null @@ -1,69 +0,0 @@ -# O que é Open Source? - -Neste capítulo, vamos mergulhar no conceito de código aberto, sua definição e sua história. Obter uma compreensão profunda do código aberto ajudará você a apreciar o contexto em que estará a colaborar e contribuindo. - -## Definição - -O termo "código aberto" refere-se a um tipo de software cujo código-fonte é disponibilizado ao público, permitindo que qualquer pessoa visualize, use, modifique e distribua o código. Isso é em contraste com o software proprietário, onde o código-fonte é mantido em segredo e apenas o programa compilado é distribuído. O princípio básico por trás do código aberto é a ideia de colaboração e a crença de que o compartilhamento de conhecimento e recursos leva a um software melhor, mais confiável e mais inovador. - -Um software de código aberto é construído com base na premissa de que, quando muitas pessoas trabalham juntas, elas podem criar algo maior do que a soma das suas partes. Os contribuidores para projetos de código aberto vêm de origens diversas e trazem uma ampla gama de habilidades, experiências e perspetivas para a mesa. Essa diversidade de pensamento e experiência leva a um software mais robusto, inovador e confiável. - -### Licenças de código aberto - -Para que um software seja considerado de código aberto, ele deve ser lançado sob uma licença que conceda aos usuários o direito de acessar, modificar e distribuir o código-fonte. Existem inúmeras licenças de código aberto disponíveis, cada uma com o seu próprio conjunto de termos e condições. Algumas licenças de código aberto populares incluem a Licença MIT, a Licença Pública Geral GNU (GPL) e a Licença Apache. - -Essas licenças são cruciais porque garantem que o software permaneça aberto e acessível a todos. Ao conceder aos usuários o direito de visualizar, modificar e distribuir o código, as licenças de código aberto promovem uma cultura de colaboração, inovação e conhecimento compartilhado. - -## História breve do código aberto - -A ideia de compartilhar livremente conhecimento e recursos existe há séculos, mas o movimento de código aberto como o conhecemos hoje pode ser rastreado aos primeiros dias da computação. - -### Primeiros aparecimentos - -Nos anos 50 e 60, o software de computador era frequentemente agrupado com hardware, e o código-fonte era compartilhado livremente entre pesquisadores e desenvolvedores. Durante esse período, era comum que os programadores colaborassem, compartilhassem ideias e modificassem o código uns dos outros para melhorar e inovar. - -No entanto, na década de 1970, à medida que a indústria de software começou a crescer e a comercializar, as empresas começaram a ver o software como um ativo e começaram a restringir o acesso ao código-fonte. Essa mudança marcou o início da divisão entre software proprietário e o emergente movimento de código aberto. - -### O nascimento do software livre - -Como consequência da crescente restrição ao acesso ao código-fonte, o programador Richard Stallman fundou a Free Software Foundation (FSF) em 1985. O objetivo da FSF era promover o desenvolvimento e o uso de software livre, que eles definiram como software que concede aos usuários a liberdade de executar, estudar, compartilhar e modificar o código. Esse conceito é semelhante ao código aberto, mas enfatiza mais os aspectos éticos e políticos da liberdade de software. - -Stallman e a FSF passaram a desenvolver o Projeto GNU (que significa "GNU's Not Unix"), um esforço ambicioso para criar um sistema operativo completamente livre e aberto. Embora o Projeto GNU tenha fornecido muitos componentes essenciais, faltava uma peça crítica: um kernel livre e aberto, o componente central de um sistema operativo. - -### O surgimento do Linux - -Em 1991, um estudante finlandês de ciência da computação chamado Linus Torvalds desenvolveu um kernel livre e aberto chamado Linux. Quando combinado com o sistema GNU, o Linux formou um sistema operacional completo, livre e de código aberto que ainda é amplamente utilizado hoje. O sucesso do Linux ajudou a popularizar o conceito de código aberto e desencadeou uma onda de novos projetos, ferramentas e tecnologias. - -### A Iniciativa de Código Aberto(Open Source Initiative, abreviada OSI) - -Em 1998, Christine Peterson, diretora-executiva da Foresight, cunhou o termo "software de código aberto" como um [esforço deliberado para tornar este campo... mais compreensível para novatos e para negócios](https://opensource.com/article/18/2/coining-term-open-source-software). Ela, com Eric S. Raymond, Bruce Perens e outros desenvolvedores e defensores, criou então a Iniciativa de Código Aberto (Open Source Initiative, OSI) para espalhar mais conscientização sobre esse conceito. A partir daí, a OSI desenvolveu a definição de código aberto, um conjunto de critérios que o software deve atender para ser considerado de código aberto. Esses critérios incluem distribuição gratuita, disponibilidade de código-fonte, trabalhos derivados e integridade da licença. - -A OSI também criou a Licença de Código Aberto (Open Source License, OSL), uma licença de software que atende aos critérios de código aberto. A OSL foi posteriormente renomeada para Licença Pública Geral GNU (GPL), que é uma das licenças de código aberto mais populares e amplamente utilizadas. - -### O crescimento das comunidades de código aberto - -À medida que o movimento de código aberto ganhava força, inúmeras comunidades e plataformas surgiram para facilitar a colaboração e o compartilhamento de conhecimento. Alguns exemplos notáveis incluem: - -- **SourceForge**: Lançado em 1999, o SourceForge foi uma das primeiras plataformas baseadas na web a fornecer ferramentas e recursos para que os desenvolvedores colaborassem em projetos de código aberto. No auge, o SourceForge hospedava milhares de projetos e atraía milhões de usuários. -- **GitHub**: Fundado em 2008, o GitHub rapidamente se tornou a plataforma padrão para hospedar e colaborar em repositórios Git. Hoje, o GitHub é o lar de milhões de projetos de código aberto e possui uma comunidade vibrante de colaboradores de todo o mundo. -- **GitLab**: Lançado em 2011 como uma alternativa de código aberto ao GitHub, o GitLab oferece um conjunto de ferramentas e recursos para gerir repositórios Git, rastrear problemas e facilitar a colaboração. - -Essas plataformas desempenharam um papel crucial no fomento ao crescimento das comunidades de código aberto e na facilitação da contribuição e colaboração de desenvolvedores em projetos. - -### O crescimento do envolvimento corporativo - -Nos últimos anos, houve um aumento significativo do envolvimento corporativo em projetos de código aberto. Muitas empresas agora reconhecem o valor do código aberto e contribuem ativamente e apoiam vários projetos. Algumas empresas até foram tão longe a ponto de abrir seus próprios ferramentas e tecnologias internas, como o TensorFlow do Google e o React do Facebook. - -Este aumento do envolvimento corporativo não só levou a mais recursos e suporte para projetos de código aberto, mas também ajudou a legitimar o movimento de código aberto e incentivar uma adoção mais ampla. - -### A evolução do código aberto - -O movimento de código aberto percorreu um longo caminho desde os seus primórdios. Hoje, o software de código aberto está em toda parte, alimentando desde sites e aplicativos móveis até algoritmos de inteligência artificial e aprendizado de máquina. - -À medida que o código aberto continua a evoluir, novos projetos, ferramentas e tecnologias estão constantemente surgindo, empurrando os limites do que é possível e impulsionando a inovação em uma ampla gama de indústrias. - -O crescente interesse e adoção do código aberto também levaram a ecossistema de código aberto próspero de conferências, meetups e comunidades online onde os desenvolvedores podem se reunir para aprender, colaborar e compartilhar os seus conhecimentos. Ao participar desses eventos e se envolver com a comunidade de código aberto, você terá a oportunidade de expandir as suas habilidades, construir a sua rede e se manter atualizado com os últimos desenvolvimentos na �rea. - -No próximo capítulo, exploraremos os muitos benefícios de contribuir para projetos de código aberto e discutiremos como a colaboração de código aberto pode ajudá-lo a acessar conhecimento, se conectar com uma comunidade e desenvolver habilidades valiosas. - -[Próximo Capítulo ->](./03-why-open-source.md) \ No newline at end of file diff --git a/translations/pt-br/03-por-que-open-source.md b/translations/pt-br/03-por-que-open-source.md deleted file mode 100644 index 26a08c1f..00000000 --- a/translations/pt-br/03-por-que-open-source.md +++ /dev/null @@ -1,57 +0,0 @@ -# Por que Open Source? - -Na seção anterior, exploramos o conceito de código aberto e sua história. Agora, vamos nos aprofundar nos muitos benefícios de contribuir para projetos de código aberto. Ao entender as vantagens da colaboração de código aberto, você estará mais bem equipado para aproveitar as oportunidades que ela apresenta e aproveitar ao máximo sua jornada de código aberto. - -## Acesso ao conhecimento - -Um dos principais benefícios de contribuir para projetos de código aberto é a oportunidade de acessar uma riqueza de conhecimento e recursos. Como contribuidor de código aberto, você poderá: - -1. **Aprenda com projetos reais**: Projetos de código aberto oferecem uma oportunidade única de estudar e aprender com bases de código do mundo real. Ao examinar como outros desenvolvedores enfrentaram problemas complexos, você pode obter insights sobre as melhores práticas, padrões de design e técnicas de ponta que pode aplicar aos seus próprios projetos. - -2. **Acesse perspetivas diversas**: Projetos de código aberto atraem contribuidores de todo o mundo, cada um trazendo seu próprio conjunto único de habilidades, experiências e perspectivas. Ao colaborar com outras pessoas, você pode ampliar sua compreensão de diferentes tecnologias, linguagens de programação e metodologias de desenvolvimento. - -3. **Mantenha-se atualizado com as últimas tendências**: A comunidade de código aberto geralmente está na vanguarda da inovação, com novos projetos, ferramentas e tecnologias constantemente surgindo. Ao participar de projetos de código aberto, você pode se manter atualizado com os últimos desenvolvimentos em sua área e aprender sobre tendências emergentes e melhores práticas. - -4. **Acesse recursos de alta qualidade**: A comunidade de código aberto é conhecida por seu compromisso em produzir documentação, tutoriais e outros recursos educacionais de alta qualidade. Ao aproveitar essa riqueza de conhecimento, você pode aprofundar sua compreensão de várias tecnologias e conceitos e continuar a crescer como desenvolvedor. - -## Acesso à comunidade - -A comunidade de código aberto é uma rede diversificada e global de desenvolvedores, entusiastas e defensores que compartilham uma paixão comum pela colaboração e compartilhamento de conhecimento. Ao contribuir para projetos de código aberto, você pode: - -1. **Conecte-se com pessoas com ideias semelhantes**: projetos de código aberto oferecem uma oportunidade de colaborar com outras pessoas que compartilham os seus interesses e paixões. Trabalhando juntos, você pode formar conexões e amizades duradouras que podem enriquecer sua vida pessoal e profissional. - -2. **Expanda a sua rede**: A comunidade de código aberto é vasta e interconectada, com inúmeros projetos, eventos e fóruns onde os desenvolvedores se reúnem para colaborar e compartilhar conhecimento. Ao participar dessas atividades, você pode expandir sua rede profissional e se conectar com potenciais mentores, colaboradores e até empregadores. - -3. **Desenvolva habilidades de comunicação e colaboração**: trabalhar em projetos de código aberto geralmente envolve colaborar com outras pessoas, remota ou pessoalmente. Isso pode ajudá-lo a desenvolver habilidades essenciais de comunicação e colaboração, como fornecer feedback construtivo, resolver conflitos e trabalhar efetivamente em equipe. - -4. **Retribua à comunidade**: Contribuir para projetos de código aberto é uma maneira de retribuir à comunidade que lhe forneceu conhecimento e recursos valiosos. Compartilhando as suas habilidades e experiência, você pode ajudar a apoiar o crescimento e o sucesso contínuo do movimento de código aberto. - -## Acesso a habilidades - -Contribuir para projetos de código aberto pode ajudá-lo a desenvolver uma ampla gama de habilidades técnicas e não técnicas altamente valorizadas no mercado de trabalho. Como contribuidor de código aberto, você terá a oportunidade de: - -1. **Melhore as suas habilidades de programação**: Trabalhar em projetos reais é uma excelente maneira de melhorar as suas habilidades de programação e aprofundar a sua compreensão de várias tecnologias e linguagens. Ao enfrentar problemas desafiadores e aprender com outros contribuidores, você pode refinar suas habilidades e se tornar um desenvolvedor mais proficiente. - -2. **Adquira experiência com novas tecnologias**: Projetos de código aberto geralmente envolvem tecnologias e ferramentas de ponta que podem não ser usadas no seu trabalho ou estudos diários. Ao contribuir para esses projetos, você pode obter experiência prática com novas tecnologias e ampliar seu conjunto de habilidades. - -3. **Construa o seu portfólio**: Contribuir para projetos de código aberto permite que você crie um registro público do seu trabalho, mostrando as suas habilidades e experiência para potenciais empregadores. Um portfólio forte de contribuições de código aberto pode ajudá-lo a se destacar no mercado de trabalho e demonstrar seu compromisso com a aprendizagem contínua e o crescimento profissional. - -4. **Desenvolva habilidades de resolução de problemas e pensamento crítico**: trabalhar em projetos de código aberto geralmente envolve enfrentar problemas complexos e tomar decisões importantes. Ao navegar nesses desafios, você pode desenvolver habilidades valiosas de resolução de problemas e pensamento crítico que podem ser aplicadas a vários aspectos de sua vida e carreira. - -5. **Aprenda gerenciamento e organização de projetos**: contribuir para projetos de código aberto pode expô-lo a vários aspetos do gerenciamento e organização de projetos, como planejamento, documentação e controle de versão. Ao aprender a gerenciar projetos de código aberto, você pode desenvolver habilidades que podem ser aplicadas a projetos pessoais e profissionais. - -6. **Desenvolva habilidades de liderança e mentoria**: ao ganhar experiência na comunidade de código aberto, você pode se encontrar numa posição para orientar e orientar novos contribuidores. Ao assumir esses papéis de liderança, você pode desenvolver habilidades essenciais, como comunicação, empatia e delegação, que podem ajudá-lo a ter sucesso em sua carreira e vida pessoal. - -## Benefícios adicionais - -Além dos benefícios mencionados acima, contribuir para projetos de código aberto também pode fornecer várias outras vantagens, como: - -1. **Aumento das oportunidades de emprego**: Muitos empregadores valorizam a experiência de código aberto e procuram ativamente candidatos que tenham um histórico comprovado de contribuição para projetos de código aberto. Ao mostrar suas contribuições de código aberto, você pode aumentar suas chances de conseguir o emprego dos seus sonhos ou avançar em sua carreira. - -2. **Crescimento pessoal**: Contribuir para projetos de código aberto pode ser uma experiência gratificante, tanto pessoal quanto profissionalmente. Ao compartilhar suas habilidades e conhecimentos, você pode fazer uma diferença tangível no mundo e contribuir para algo maior que você. - -3. **Oportunidades de reconhecimento**: Projetos de código aberto geralmente atraem a atenção de líderes da indústria, influenciadores e veículos de mídia. Ao fazer contribuições significativas para projetos de alto perfil, você pode ganhar reconhecimento e se estabelecer como um especialista em seu campo. - -No próximo capítulo, discutiremos as ferramentas e recursos essenciais de que você precisará para ter sucesso em sua jornada de código aberto, incluindo GitHub, Git, CodeSee, VS Code e Discord. Ao se familiarizar com essas ferramentas, você estará melhor equipado para colaborar com outras pessoas, gerenciar seus projetos e contribuir efetivamente para projetos de código aberto. - -[Próximo Capítulo -->](./04-tools-to-be-successful.md) \ No newline at end of file diff --git a/translations/pt-br/04-ferramentas-utilizadas.md b/translations/pt-br/04-ferramentas-utilizadas.md deleted file mode 100644 index de4f16ee..00000000 --- a/translations/pt-br/04-ferramentas-utilizadas.md +++ /dev/null @@ -1,138 +0,0 @@ -# Ferramentas utilizadas - -Para ter sucesso na sua jornada de código aberto, é essencial familiarizar-se com as ferramentas e plataformas comumente utilizadas pela comunidade. Essas ferramentas ajudarão você a colaborar de forma eficaz, gerenciar seus projetos e contribuir para projetos de código aberto. Neste capítulo, discutiremos as seguintes ferramentas essenciais para colaboração de código aberto: - -- GitHub & Git -- CodeSee -- VS Code (O editor) -- Discord - -## Pré-requisitos - -Antes de completar o seguinte passo a passo, complete o seguinte: -- Crie uma [conta no GitHub](https://github.com/) -- Baixe o [VS Code](https://code.visualstudio.com/) - -## GitHub & Git - -### Introdução ao Git - -Git é um sistema de controlo de versão distribuído projetado para lidar com projetos pequenos e muito grandes com velocidade e eficiência. Foi criado por Linus Torvalds, o criador do kernel Linux, para gerir o desenvolvimento do próprio kernel Linux. - -Git permite que os desenvolvedores acompanhem as alterações no seu código, colaborem com outros desenvolvedores e gerenciem várias versões dos seus projetos. Alguns dos recursos principais do Git incluem: - -- **Ramificação**: Git permite que os desenvolvedores criem ramificações, cópias separadas da sua base de código. Isso permite que eles trabalhem em novos recursos ou correções de bugs sem afetar a base de código principal. Uma vez que as alterações estejam concluídas, eles podem mesclar a ramificação de volta para a base de código principal. -- **Área de preparação**: Git fornece uma área de preparação onde os desenvolvedores podem preparar as suas alterações antes de as comprometerem com o repositório. Isso permite que eles revisem e organizem as suas alterações antes de as tornarem permanentes. -- **Controle de versão distribuído**: Ao contrário dos sistemas de controlo de versão centralizados, o Git é um sistema de controlo de versão distribuído. Isso significa que cada desenvolvedor tem uma cópia completa do repositório na máquina local, permitindo-lhes trabalhar offline e independentemente de um servidor central. - -### Introdução ao GitHub - -O GitHub é uma plataforma baseada na web para controlo de versão e colaboração que utiliza o Git como tecnologia subjacente. Ele fornece uma interface simples e amigável para gerir repositórios Git, bem como uma série de recursos e ferramentas para colaborar com outros desenvolvedores. - -Algumas das principais funcionalidades do GitHub incluem: - -- **Rastramento de issues**: O GitHub fornece um sistema integrado de rastreamento de problemas que permite que os desenvolvedores criem, atribuam e gerenciem problemas relacionados aos seus projetos. Os problemas podem ser categorizados usando etiquetas, marcos e pessoas atribuídas, tornando fácil acompanhar o progresso do projeto e priorizar tarefas. -- **Pull requests**: O GitHub introduz o conceito de pedidos de pull, que permitem que os desenvolvedores proponham alterações à base de código de um projeto. Os pedidos de pull permitem a revisão de código, discussão e colaboração antes que as alterações sejam mescladas na base de código principal. -- **Forking**: O GitHub permite que os utilizadores criem uma cópia de um repositório, conhecida como fork. Isso permite que eles façam alterações na base de código sem afetar o projeto original. Uma vez que as alterações estejam concluídas, eles podem enviar um pedido de pull para que as suas alterações sejam revisadas e potencialmente mescladas na base de código principal. -- **GitHub Actions**: O GitHub Actions é uma poderosa ferramenta de automação que permite criar fluxos de trabalho personalizados para automatizar tarefas como a construção, teste e implantação do seu código. - -### Começando com Git e GitHub - -Para começar com Git e GitHub, siga estes passos: - -1. **Instalar o Git**: Baixe e instale o Git no seu computador visitando o site oficial do Git (https://git-scm.com/) e seguindo as instruções de instalação para o seu sistema operacional. -2. **Configurar o Git**: Após instalar o Git, abra um terminal ou prompt de comando e configure as informações do seu usuário Git executando os seguintes comandos: - -```bash -git config --global user.name "Seu nome" -git config --global user.email "seu.email@exemplo.com" -``` - -Substitua "Seu nome" pelo seu nome completo e "seu.email@exemplo.com" pelo endereço de e-mail que você usou para se inscrever no GitHub. - -#### Praticando Contribuições com o VS Code - -Para praticar o uso do GitHub, vamos passar por criar um repositório, clonar o repositório, fazer alterações e empurrar essas alterações. - -1. **Crie um repositório**: Faça login na sua conta do GitHub e navegue até [https://github.com/new](https://github.com/new) ou clique no ícone "+" no canto superior direito e selecione "Novo repositório" no menu suspenso. - -Escollha você mesmo como o proprietário do repositório, e digite um nome para o seu repositório. Para este exemplo, usaremos `practice-repository` - -![new repo screenshot](../../new-repo.png) - -Escollha se você quer que seja público ou privado. Você também pode escolher inicializar o repositório com um arquivo README, um arquivo .gitignore e/ou uma licença. - -Por exemplo, inicialize o repositório com um arquivo README. - -2. **Clone o repositório**: Uma vez que você tenha criado um repositório, você pode cloná-lo para a sua máquina local executando o seguinte comando no seu terminal ou prompt de comando: - -```bash -git clone https://github.com/username/repository-name.git -``` - -Substitua "username" pelo seu nome de utilizador do GitHub e "repository-name" por `practice-repository`. - -3. **Acesse o seu repositório no seu editor de código**: Para este exemplo, estamos usando o VS Code. Abra o VS Code, navegue até a guia de arquivos e abra o seu `practice-repository`. - -4. **Faça alterações e confirme**: Deve haver um arquivo no seu repositório: `README.md`. Dentro desse arquivo, abaixo de `# practice-repository`, digite 'hello world!' Após ter feito alterações, você pode prepará-las e confirmá-las. - -Abra o seu terminal e certifique-se de que está no diretório correto. Por exemplo, os meus projetos de codificação estão dentro da minha pasta `Projects`. Usando o meu terminal, eu acessaria este repositório executando este comando: - -```bash -cd projects/practice-repository -``` - -Agora que você está no diretório correto, use os seguintes comandos para adicionar as alterações que você fez e escrever uma mensagem de confirmação com uma descrição das alterações: - -```bash -git add . -git commit -m "Your commit message" -``` - -Substitua "Your commit message" por uma breve descrição das alterações que você fez. - -5. **Empurre as suas alterações**: Após confirmar as suas alterações, você pode empurrá-las para o seu repositório remoto no GitHub executando o seguinte comando: - -```bash -git push origin main -``` - -O commando `push origen main` empurra as suas alterações para o ramo "main" do seu repositório remoto. Se você quiser verificar o seu trabalho, navegue até o seu repositório do GitHub. Você deve ver 'hello world!' no seu arquivo README.md. - -Você agora configurou com sucesso o Git e o GitHub na sua máquina local e está pronto para colaborar em projetos de código aberto! - -## CodeSee - -CodeSee é uma poderosa ferramenta de visualização que ajuda os desenvolvedores a entenderem bases de código complexas e a navegarem em grandes projetos de forma mais eficiente. Ao fornecer uma representação visual do seu código, o CodeSee permite que você: - -- **Identificar dependências**: O CodeSee ajuda você a entender como diferentes partes da sua base de código estão conectadas e como as alterações numa área podem afetar outras áreas. -- **Analisar a estrutura do código**: O CodeSee permite que você visualize a estrutura do seu código, facilitando identificar padrões, antipadrões e áreas para melhorias. -- **Navegar em grandes bases de código**: com o CodeSee, você pode navegar rapidamente em grandes bases de código e encontrar as partes do código que você precisa trabalhar. - -Para começar com o CodeSee, visite o site oficial (https://www.codesee.io/) e siga as instruções para instalar a extensão do navegador e integrá-la com a sua conta do GitHub.ub account. - -## VS Code - -Visual Studio Code (VS Code) é um editor de código popular, gratuito e de código aberto desenvolvido pela Microsoft. Ele suporta uma ampla gama de linguagens de programação e oferece muitos recursos que o tornam uma ótima escolha para o desenvolvimento de código aberto, incluindo: - -- **Suporte Git integrado**: O VS Code oferece suporte integrado para Git, permitindo que você gerencie os seus repositórios Git, estágio e confirme alterações e resolva conflitos de mesclagem diretamente do editor. -- **Extensibilidade**: O VS Code oferece um rico ecossistema de extensões que podem aprimorar a sua experiência de desenvolvimento e adicionar suporte para idiomas, ferramentas e estruturas adicionais. -- **Terminal integrado**: O VS Code inclui um terminal integrado que permite executar comandos, scripts e tarefas de compilação diretamente do editor. -- **Customizável**: O VS Code é altamente customizável, permitindo que você adapte o editor às suas preferências e fluxo de trabalho. Você pode personalizar o tema, keybindings e configurações para criar um ambiente de desenvolvimento personalizado. - -Para baixar e instalar o VS Code, visite o site oficial (https://code.visualstudio.com/) e siga as instruções para o seu sistema operativo. - -## Discord - -O Discord é uma plataforma popular de mensagens e chat de voz amplamente utilizada por comunidades de código aberto para comunicação e colaboração. Ao juntar-se a servidor Discord relacionados aos seus interesses e projetos, você pode: - -- **Conecte-se com outros desenvolvedores**: O Discord permite que você converse com outros desenvolvedores, faça perguntas e compartilhe o seu conhecimento com a comunidade. -- **Mantenha-se atualizado**: muitos projetos de código aberto usam o Discord para compartilhar atualizações, anúncios e outras informações importantes. Ao juntar-se aos seus servidores, você pode se manter informado sobre os últimos desenvolvimentos e contribuir de forma mais eficaz. -- **Participar de discussões**: Os servidores do Discord muitas vezes hospedam discussões sobre vários tópicos relacionados ao desenvolvimento de código aberto. Ao participar dessas discussões, você pode aprender com os outros, compartilhar as suas ideias e contribuir para o conhecimento coletivo da comunidade. -- **Encontre oportunidades de colaboração**: Os servidores do Discord podem ser um ótimo lugar para encontrar outras pessoas que compartilham os seus interesses e procuram oportunidades de colaboração. Ao fazer networking com outros desenvolvedores, você pode descobrir novos projetos para trabalhar e formar parcerias valiosas. - -Para começar com o Discord, visite o site oficial (https://discord.com/) e inscreva-se para uma conta. Após ter uma conta, você pode procurar por comunidades e projetos de código aberto em plataformas como GitHub, GitLab ou OpenSauced para encontrar os seus servidores do Discord e juntar-se à conversa. - -Familiarizando-se com essas ferramentas e plataformas, você estará equipado para colaborar efetivamente, gerir os seus projetos e contribuir para projetos de código aberto. No próximo capítulo, discutiremos como contribuir para projetos de código aberto, incluindo encontrar projetos para trabalhar, enviar contribuições e o que acontece depois que a sua contribuição é aceite. - -[Próximo Capítulo ->](./05-how-to-contribute-to-open-source.md) \ No newline at end of file diff --git a/translations/pt-br/05-como-contribuir-para-open-source.md b/translations/pt-br/05-como-contribuir-para-open-source.md deleted file mode 100644 index 16b4ef51..00000000 --- a/translations/pt-br/05-como-contribuir-para-open-source.md +++ /dev/null @@ -1,28 +0,0 @@ -# Como Contribuir Para Open Source - -Neste capítulo, vamos guiá-lo pelo processo de contribuição para projetos de open source. Abordaremos os seguintes tópicos: - -- Encontrar projetos para trabalhar -- Como enviar uma contribuição -- Integração em um novo projeto -- O que acontece depois? - -## Encontrar projetos para trabalhar - -Um dos primeiros desafios que você pode enfrentar ao começar com o código -aberto é encontrar um projeto para o qual contribuir. -Aqui estão algumas dicas para ajudá-lo a descobrir projetos que se alinham com seus interesses e habilidades: - -1. **Navegue no GitHub e no GitLab**: Tanto o GitHub quanto o GitLab hospedam um grande número de projetos de open source. -Você pode usar a funcionalidade de pesquisa para encontrar projetos com base em palavras-chave, linguagens de programação ou tópicos específicos. - -2. **Siga seus interesses**: Pense nas ferramentas, estruturas e bibliotecas que você usa ou sobre as quais tem interesse em aprender mais. Muitos desses projetos são de open source e recebem contribuições da comunidade. - -3. **Junte-se a comunidades de código aberto**: Existem várias comunidades on-line, fóruns e plataformas de bate-papo dedicadas ao desenvolvimento de open source. -Ao ingressar nessas comunidades, você pode se conectar com outros desenvolvedores, descobrir novos projetos e encontrar oportunidades de colaboração. -No [Discord do OpenSauced](https://discord.com/invite/U2peSNf23P), por exemplo, compartilhamos bons primeiros problemas, projetos legais do GitHub e problemas que abrimos em nossos repositórios. - -4. **Aproveite o OpenSauced**: [OpenSauced](https://opensauced.pizza/) é uma plataforma que ajuda os desenvolvedores a descobrir e contribuir com projetos de open source. -Ao usar o OpenSauced, você pode encontrar projetos alinhados com seus interesses, habilidades e objetivos. - -[Próximo Capítulo ->](./06-the-secret-sauce.md) \ No newline at end of file diff --git a/translations/pt-br/06-o-molho-secreto.md b/translations/pt-br/06-o-segredo-do sauce.md similarity index 99% rename from translations/pt-br/06-o-molho-secreto.md rename to translations/pt-br/06-o-segredo-do sauce.md index 6021d4cd..a8bfecfa 100644 --- a/translations/pt-br/06-o-molho-secreto.md +++ b/translations/pt-br/06-o-segredo-do sauce.md @@ -1,4 +1,4 @@ -# O Molho Secreto +# O segredo do sauce Neste capítulo, vamos compartilhar algumas estratégias e dicas menos conhecidas para causar um impacto duradouro na comunidade de código aberto. Discutiremos como focar em issues abertos, ganhar tração em suas contribuições e desenvolver seu currículo de código aberto usando o OpenSauced. diff --git "a/translations/pt-br/07-conclus\303\243o.md" "b/translations/pt-br/07-conclus\303\243o.md" deleted file mode 100644 index da4a5aed..00000000 --- "a/translations/pt-br/07-conclus\303\243o.md" +++ /dev/null @@ -1,39 +0,0 @@ -# Conclusão - -Como concluímos este curso sobre como começar com open source, vamos recapitular as principais conclusões e discutir o que vem a seguir em sua jornada de open source. - -## Considerações gerais - -Ao longo deste curso, cobrimos uma variedade de tópicos projetados para ajudá-lo a entender e navegar pelo mundo do open source: - -1. **O que é open source?**: Discutimos a definição de open source, sua história e os princípios básicos que orientam o movimento open source. - -2. **Por que open source?**: Exploramos os benefícios de se envolver com projetos de open source, incluindo acesso ao conhecimento, comunidade e desenvolvimento de habilidades. - -3. **Ferramentas para ter sucesso**: Apresentamos ferramentas e plataformas essenciais para colaboradores de open source, como GitHub, Git, CodeSee, Visual Studio Code e Discord. - -4. **Como contribuir para open source**: Discutimos o processo de encontrar projetos para trabalhar, enviar contribuições, embarcar em novos projetos e o que acontece depois que sua contribuição é enviada. - -5. **O segredo do sauce**: Compartilhamos estratégias para começar com contribuições de open source, ganhar tração em suas contribuições e desenvolver seu currículo de open source usando o OpenSauced. - -Ao entender esses conceitos e aplicar as estratégias que discutimos, você estará bem equipado para embarcar em uma jornada de open source bem-sucedida. - -# O que vem a seguir? - -Com o conhecimento e as ferramentas que você adquiriu neste curso, você está pronto para mergulhar no mundo do open source e começar a fazer contribuições significativas. Aqui estão alguns próximos passos para ajudá-lo a continuar sua jornada de open source: - -1. **Identifique seus interesses e objetivos**: Antes de começar a contribuir para projetos de open source, reserve um tempo para pensar em seus interesses, paixões e objetivos. Isso ajudará você a identificar projetos que se alinham com seus valores e objetivos. - -2. **Encontre projetos para contribuir**: Use plataformas como GitHub, OpenSauced e CodeTriage para descobrir projetos de open source que se alinham com seus interesses e habilidades. Procure projetos com comunidades ativas, documentação clara e diretrizes de contribuição bem definidas. - -3. **Comece a contribuir**: Depois de identificar um projeto para contribuir, comece abordando tarefas pequenas e gerenciáveis para construir sua confiança e ganhar experiência. À medida que você se sentir mais confortável, assuma tarefas e desafios mais complexos. - -4. **Conecte-se com a comunidade de open source**: Junte-se a fóruns on-line, plataformas de bate-papo e grupos de mídia social relacionados aos projetos que você está interessado. Interaja com outros colaboradores, faça perguntas e compartilhe seu conhecimento. - -5. **Participe de eventos e conferências**: Participe de eventos, conferências e encontros de open source para aprender com os outros, fazer networking com outros desenvolvedores e se manter atualizado sobre as últimas tendências e melhores práticas no mundo do open source. - -6. **Compartilhe suas experiências**: Documente sua jornada de open source escrevendo postagens de blog, criando tutoriais ou dando apresentações. Isso não apenas ajudará os outros a aprender com suas experiências, mas também o estabelecerá como um líder de pensamento na comunidade de open source. - -7. **Continue aprendendo**: O open source é um campo dinâmico e em constante evolução. Mantenha-se atualizado com as últimas ferramentas, técnicas e melhores práticas participando de workshops, fazendo cursos on-line e lendo artigos e livros sobre desenvolvimento de open source. Incluímos uma [seção de recursos adicionais](./08-additional-resources.md) para obter mais informações. - -Em conclusão, embarcar em uma jornada de open source é uma experiência gratificante e enriquecedora que pode ajudá-lo a desenvolver novas habilidades, se conectar com pessoas de mentalidade semelhante e ter um impacto duradouro nos projetos em que trabalha. Com o conhecimento e as ferramentas que você adquiriu neste curso, você está bem preparado para enfrentar os desafios e oportunidades emocionantes que o aguardam no mundo do open source. Então vá em frente e comece a contribuir - a comunidade de open source aguarda ansiosamente sua participação! \ No newline at end of file diff --git a/translations/pt-br/08-recursos-adicionais.md b/translations/pt-br/08-recursos-adicionais.md deleted file mode 100644 index 5ff6e1c0..00000000 --- a/translations/pt-br/08-recursos-adicionais.md +++ /dev/null @@ -1,25 +0,0 @@ -Felicitações por sua jornada no open source! Aqui estão alguns recursos para aprender mais sobre como começar no open source:source: - -## Guias e Tutoriais - -- [Open Source Guides](https://opensource.guide/) por GitHub: Guias abrangentes sobre vários aspectos do open source, incluindo como começar, contribuir, manter projetos e construir comunidades. - -- [Primeira Contribuição](https://github.com/firstcontributions/first-contributions) por Roshan Jossey: Um guia para iniciantes que o guia por sua primeira contribuição para um projeto de código aberto. - -- [Guia para iniciantes em Desenvolvimento de Software Open Source](https://training.linuxfoundation.org/training/beginners-guide-open-source-software-development/) por The Linux Foundation: Um curso online gratuito que aborda os conceitos básicos do open source, incluindo sua história, licenças e modelos de desenvolvimento. - -- [Mozilla's Open Source Student Network (OSSN)](https://community.mozilla.org/en/): Fornece recursos e suporte para estudantes interessados em open source, incluindo guias, eventos e oportunidades de mentoria. - -- [Introdução ao GitHub e projetos Open Source](https://www.digitalocean.com/community/tutorial_series/an-introduction-to-open-source) por DigitalOcean: Uma série de tutoriais para iniciantes que aborda os conceitos básicos do open source, incluindo como encontrar projetos para contribuir, entender o código e enviar contribuições. - -- [Open Source Friday](https://opensourcefriday.com/) por GitHub: Um movimento global que incentiva indivíduos e organizações a contribuir para o open source todas as sextas-feiras. O site fornece recursos e guias sobre como começar no open source e encontrar projetos para contribuir. - -## Blog posts - -- [Além da Criação de Conteúdo: Como as Contribuições de Open Source Podem Ajudá-lo a Ser Notado](https://dev.to/opensauced/beyond-content-creation-how-open-source-contributions-can-help-you-get-noticed-4l5n) - -- [Escrevendo sua primeira Pull Request: Dicas, Melhores Práticas e Ferramentas com Inteligência Artificial para o Sucesso](https://dev.to/opensauced/writing-your-first-pull-request-tips-best-practices-and-ai-powered-tools-for-success-3bg9) - -- [Como Contribuir para Open Source sem Saber Programar: Um guia com sugestões de projetos](https://dev.to/opensauced/how-to-contribute-to-open-source-without-knowing-how-to-code-a-guide-with-project-suggestions-59e5) - -- [Como Escrever uma Boa Issue: Dicas para Comunicação Eficaz em Open Source](https://dev.to/opensauced/how-to-write-a-good-issue-tips-for-effective-communication-in-open-source-5443) \ No newline at end of file diff --git "a/translations/pt-br/09-gloss\303\241rio.md" "b/translations/pt-br/09-gloss\303\241rio.md" deleted file mode 100644 index 9b14d18c..00000000 --- "a/translations/pt-br/09-gloss\303\241rio.md" +++ /dev/null @@ -1,88 +0,0 @@ -## Repositório - -Um repositório é um local central onde o código é armazenado e gerenciado. Em open source, os repositórios geralmente são hospedados em plataformas como GitHub, GitLab ou Bitbucket. Cada repositório pode conter um ou mais projetos, e os contribuidores podem enviar alterações no código fazendo solicitações pull. - -## Mantenedor - -Um mantenedor é uma pessoa ou um grupo de pessoas responsável por manter um projeto de open source específico. Os mantenedores são normalmente responsáveis ​​por revisar e aceitar ou rejeitar as contribuições de outros contribuidores. Eles também têm autoridade para tomar as decisões finais sobre a direção e o escopo do projeto. - -## Membro Principal - -Um membro principal é um colaborador que recebeu privilégios ou responsabilidades adicionais em um projeto de open source. Os membros principais geralmente são colaboradores confiáveis ​​que demonstraram um profundo conhecimento do projeto e fizeram contribuições significativas para o seu desenvolvimento. - -## Emitir - -Um problema é um problema ou bug que precisa ser resolvido no código. Os problemas podem ser criados por qualquer pessoa e geralmente são usados ​​para rastrear bugs, solicitações de recursos e outras tarefas que precisam ser executadas. - -# Contribuidor - -Um colaborador é qualquer pessoa que faz alterações, acréscimos ou sugestões a um projeto de open source. Os colaboradores podem ser desenvolvedores, designers, escritores, testadores ou qualquer outra pessoa que ajude a tornar o projeto melhor. - -## Clonar - -A clonagem é o processo usado para copiar um repositório Git existente para um novo diretório local. O comando `git clone` criará um novo diretório local para o repositório, copiará todo o conteúdo do repositório especificado, criará os branches rastreados remotos e fará o checkout de um branch inicial localmente. Por padrão, o clone do Git criará uma referência ao repositório remoto chamado origin. - -## Garfo - -Uma bifurcação é uma cópia de um repositório. Ao bifurcar um repositório, você cria uma nova cópia da base de código que pode modificar e experimentar sem afetar a base de código original. - -## Filial - -Uma ramificação é uma versão separada do código criada para fins de desenvolvimento. As ramificações permitem que os contribuidores experimentem as alterações sem afetar a base de código principal. Quando as alterações estão prontas para serem mescladas na base de código principal, elas geralmente são enviadas como uma pull request. - -## Solicitação de pull - -Uma solicitação pull é uma solicitação de um contribuidor a um mantenedor para que as alterações feitas no código sejam inseridas em uma base de código. - -## Mesclar - -Mesclar é o processo de combinar alterações de uma ramificação em outra. Quando uma solicitação pull é aceita e mesclada, as alterações feitas na solicitação pull tornam-se parte da base de código principal. - -## Documentos - -Esta é uma abreviação da palavra documentação, um pedaço de texto que fornece informações sobre como contribuir para projetos OSS e expectativas para contribuidores. Markdown, uma linguagem de codificação baseada em texto, é frequentemente usada para criar essas formas de conteúdo. Quer ver um em ação? Confira o [Guia de estilo em nosso repositório Pizza Verse](https://github.com/open-sauced/pizza-verse/blob/main/style-guide.md)! -Esta é uma abr## Repositório - -Um repositório é um local central onde o código é armazenado e gerenciado. Em open source, os repositórios geralmente são hospedados em plataformas como GitHub, GitLab ou Bitbucket. Cada repositório pode conter um ou mais projetos, e os contribuidores podem enviar alterações no código fazendo solicitações pull. - -## Mantenedor - -Um mantenedor é uma pessoa ou um grupo de pessoas responsável por manter um projeto de open source específico. Os mantenedores são normalmente responsáveis ​​por revisar e aceitar ou rejeitar as contribuições de outros contribuidores. Eles também têm autoridade para tomar as decisões finais sobre a direção e o escopo do projeto. - -## Membro Principal - -Um membro principal é um colaborador que recebeu privilégios ou responsabilidades adicionais em um projeto de open source. Os membros principais geralmente são colaboradores confiáveis ​​que demonstraram um profundo conhecimento do projeto e fizeram contribuições significativas para o seu desenvolvimento. - -## Emitir - -Um problema é um problema ou bug que precisa ser resolvido no código. Os problemas podem ser criados por qualquer pessoa e geralmente são usados ​​para rastrear bugs, solicitações de recursos e outras tarefas que precisam ser executadas. - -# Contribuidor - -Um colaborador é qualquer pessoa que faz alterações, acréscimos ou sugestões a um projeto de open source. Os colaboradores podem ser desenvolvedores, designers, escritores, testadores ou qualquer outra pessoa que ajude a tornar o projeto melhor. - -## Clonar - -A clonagem é o processo usado para copiar um repositório Git existente para um novo diretório local. O comando `git clone` criará um novo diretório local para o repositório, copiará todo o conteúdo do repositório especificado, criará os branches rastreados remotos e fará o checkout de um branch inicial localmente. Por padrão, o clone do Git criará uma referência ao repositório remoto chamado origin. - -## Garfo - -Uma bifurcação é uma cópia de um repositório. Ao bifurcar um repositório, você cria uma nova cópia da base de código que pode modificar e experimentar sem afetar a base de código original. - -## Filial - -Uma ramificação é uma versão separada do código criada para fins de desenvolvimento. As ramificações permitem que os contribuidores experimentem as alterações sem afetar a base de código principal. Quando as alterações estão prontas para serem mescladas na base de código principal, elas geralmente são enviadas como uma pull request. - -## Solicitação de pull - -Uma solicitação pull é uma solicitação de um contribuidor a um mantenedor para que as alterações feitas no código sejam inseridas em uma base de código. - -## Mesclar - -Mesclar é o processo de combinar alterações de uma ramificação em outra. Quando uma solicitação pull é aceita e mesclada, as alterações feitas na solicitação pull tornam-se parte da base de código principal. - -## Documentos - -Isso é uma abreviação da palavra "documentação", um pedaço de texto que fornece informações sobre como contribuir para projetos de código aberto e expectativas para os contribuidores. -O Markdown, uma linguagem de codificação baseada em texto, é frequentemente usado para criar esse tipo de conteúdo. -Quer ver um exemplo em ação? Confira o [Guia de Estilo no nosso repositório Pizza Verse](https://github.com/open-sauced/pizza-verse/blob/main/style-guide.md)! diff --git a/translations/pt-br/README.pt.md b/translations/pt-br/README.pt.md new file mode 100644 index 00000000..6ac8bb69 --- /dev/null +++ b/translations/pt-br/README.pt.md @@ -0,0 +1,53 @@ +
+
+ Open Sauced +

🍕 Introdução ao Open Source com OpenSauced 🍕

+ O site fornece materiais do curso Introdução ao Open Source com OpenSauced. +
+
+ +Bem-vindo ao curso de Introdução ao Open Source com OpenSauced! Este curso foi projetado para fornecer uma introdução ao open source e orientá-lo no processo de contribuição para projetos de código aberto. + +## Suporte de idioma + +- [English](../../README.md) + +## Visão geral do curso + +O curso é dividido em cinco capítulos, cada um cobrindo um aspecto diferente do open source: + +1. **O que é open source?** Este capítulo fornece uma introdução ao open source, sua história e sua importância no cenário atual de desenvolvimento de software. + +2. **Por que open source?** Neste capítulo, você aprenderá sobre os benefícios do software open source, como colaboração aumentada, desenvolvimento mais rápido e qualidade aprimorada. + +3. **Ferramentas para ter sucesso.** Descubra as principais ferramentas e plataformas necessárias para uma jornada de sucesso no desenvolvimento de código aberto. Do Git e GitHub para controle de versão e colaboração ao CodeSee para visualização de código e VS Code como seu editor de código, este capítulo fornece uma visão geral de como aproveitar essas ferramentas essenciais. + +4. **Como contribuir para o open source.** +Este capítulo abrange a busca de projetos para trabalhar, o envio de contribuições, a integração em novos projetos e os resultados após o envio de contribuições. As dicas para encontrar projetos incluem navegar no GitHub e GitLab, seguir interesses pessoais, participar de comunidades de código aberto e utilizar plataformas como OpenSauced. + +5. **O molho secreto.** +Este capítulo se concentra em fornecer estratégias e dicas menos conhecidas para causar um impacto duradouro na comunidade de código aberto. Este capítulo fornece estratégias para encontrar problemas, ganhar tração em sua jornada de código aberto e alavancar o OpenSauced para construir seu currículo de código aberto. + +## Informações adicionais + +Este é o início da sua jornada de código aberto, por isso fornecemos alguns recursos adicionais para ajudá-lo a começar: +- [Glossário](/translations/pt-br/09-glossário.md): Um glossário de termos e definições comuns usados no open source. +- [Recursos adicionais](/translations/pt-br/08-recursos-adicionais.md): Uma lista de recursos adicionais para aprender mais sobre open source, incluindo postagens de blog, tutoriais e guias. + +## Começando + +Para começar o curso, basta navegar até o arquivo [`intro`](/translations/pt-br/01-introdução.md) no repositório e começar a ler! Cada capítulo se baseia no anterior, portanto, recomendamos lê-los em ordem. + +Conforme você trabalha no curso, incentivamos você a experimentar as ferramentas e conceitos abordados em cada capítulo. A melhor maneira de aprender é fazendo, portanto, tente contribuir para um projeto de código aberto real ou criar seu próprio projeto do zero! + +## Construindo seu currículo código aberto + +Um dos recursos exclusivos deste curso é que ele fornece orientações sobre como construir seu currículo de código aberto usando o OpenSauced. O OpenSauced é uma plataforma que ajuda você a rastrear e mostrar suas contribuições de código aberto, facilitando a notificação por potenciais empregadores e colaboradores. + +Para saber mais sobre como usar o OpenSauced para construir seu currículo de código aberto, não deixe de conferir a seção `Construindo seu currículo de código aberto` no [Capítulo 6 - O segredo do sauce](./06-the-secret-sauce.md). + +
+ +Nós da Open Sauced estamos muito animados para compartilhar este curso com você! Esperamos que você ache este curso informativo e útil! Se você tiver alguma dúvida ou comentário, não hesite em abrir uma issue ou entrar em contato conosco na comunidade OpenSauced Discord. + +Feliz aprendizado e contribuição! diff --git a/translations/pt-br/sidebar.md b/translations/pt-br/sidebar.md deleted file mode 100644 index 33833659..00000000 --- a/translations/pt-br/sidebar.md +++ /dev/null @@ -1,10 +0,0 @@ -- Páginas - - [Introdução](/translations/pt-br/01-introdução.md) - - [O que é Open Source?](/translations/pt-br/02-o-que-é-open-source.md) - - [Por que Open Source?](/translations/pt-br/03-por-que-open-source.md) - - [Ferramentas utilizadas](/translations/pt-br/04-ferramentas-utilizadas.md) - - [Como Contribuir Para Open Source](/translations/pt-br/05-como-contribuir-para-open-source.md) - - [O segredo do sauce](/translations/pt-br/06-o-molho-secreto.md) - - [Conclusão](/translations/pt-br/07-conclusão.md) - - [Recursos Adicionais](/translations/pt-br/08-recursos-adicionais.md) - - [Glossário](/translations/pt-br/09-glossário.md) \ No newline at end of file From 1a9e09d184ff5339c86cccff813f2e375d71374b Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Tue, 19 Sep 2023 20:45:42 -0400 Subject: [PATCH 04/62] fix: revise translation of chapter 5 --- .../pt-br/01-introdu\303\247\303\243o.md" | 67 --------------- translations/pt-br/06-o-segredo-do sauce.md | 81 ------------------- 2 files changed, 148 deletions(-) delete mode 100644 "translations/pt-br/01-introdu\303\247\303\243o.md" delete mode 100644 translations/pt-br/06-o-segredo-do sauce.md diff --git "a/translations/pt-br/01-introdu\303\247\303\243o.md" "b/translations/pt-br/01-introdu\303\247\303\243o.md" deleted file mode 100644 index bf8b3a8c..00000000 --- "a/translations/pt-br/01-introdu\303\247\303\243o.md" +++ /dev/null @@ -1,67 +0,0 @@ -# Introdução - -Bem-vindo ao curso "Getting Started with Open Source"! -Este curso abrangente irá guiá-lo pelo fascinante mundo do open source e ajudá-lo a se tornar um colaborador ativo. -Ao final deste curso, você deve ter uma compreensão sólida de como encontrar, participar e contribuir para projetos de open source, bem como como desenvolver seu currículo de open source. -Mas primeiro, vamos preparar o cenário discutindo os pré-requisitos, objetivos e expectativas para este curso. - -## Pré-requisitos - -Antes de mergulhar no mundo do open source, é essencial ter uma compreensão básica dos conceitos de programação e alguma experiência trabalhando com código. -Embora o curso forneça exemplos e demonstrações, você obterá o máximo do material se tiver algum conhecimento prévio. - -Além disso, este curso pressupõe que você esteja familiarizado com o Git e o GitHub. -O Git é um sistema de controle de versão amplamente utilizado, e o GitHub é uma plataforma popular para hospedar e colaborar em repositórios Git. - -Se você ainda não está familiarizado com o Git e o GitHub, recomendamos que você reserve um tempo para aprender o básico antes de iniciar este curso. - -## Objetivos - -Ao longo deste curso, nossos principais objetivos são ajudá-lo a: - -1. **Entender o open source e seus benefícios**: exploraremos o conceito de open source, sua história e as inúmeras vantagens de contribuir para projetos de open source. -2. **Aprenda a encontrar projetos de open source**: descobrir projetos que se alinham com seus interesses e habilidades é crucial para uma experiência de open source gratificante. Apresentaremos a você ferramentas e técnicas para encontrar projetos para contribuir. -3. **Dominar as ferramentas e processos para contribuir**: forneceremos uma visão geral das ferramentas e processos essenciais para uma colaboração de open source bem-sucedida, como controle de versão, revisão de código e plataformas de comunicação. -4. **Adquira experiência prática**: seguindo exemplos e demonstrações, você terá a oportunidade de praticar suas habilidades e ganhar confiança em sua capacidade de contribuir para projetos de open source. -5. **Desenvolva seu currículo de open source**: mostrar suas contribuições de open source é vital para construir sua reputação na comunidade e demonstrar sua experiência para potenciais empregadores ou clientes. Discutiremos estratégias para desenvolver e manter seu currículo de open source. - -## Expectativas - -Este curso foi projetado para fornecer uma base sólida em colaboração de open source. -Embora cubramos uma variedade de tópicos e forneçamos exemplos, demonstrações e oportunidades para prática, é essencial ter expectativas realistas sobre o que você pode alcançar durante o curso. - -1. **A prática é crucial**: aprender sobre open source é apenas o começo; para se tornar um colaborador proficiente, você precisará praticar consistentemente. -Tenha em mente que quanto mais você contribuir para projetos de open source, mais aprenderá e crescerá como desenvolvedor. - -2. **A paciência é fundamental**: tornar-se proficiente em colaboração de open source leva tempo e esforço. Não se desanime se encontrar desafios ao longo do caminho; lembre-se de que toda contribuição, por menor que seja, é valiosa e ajuda a melhorar o projeto. - -3. **Engajamento com a comunidade**: o open source é mais do que apenas código; trata-se das pessoas que colaboram e contribuem para projetos. Engaje-se com a comunidade fazendo perguntas, compartilhando seu conhecimento e apoiando os outros. -Construir relacionamentos com outros colaboradores aprimorará sua experiência de open source e ajudará você a crescer como desenvolvedor. - -4. **Aprendizado contínuo**: o open source é um campo em rápida evolução, com novos projetos, ferramentas e tecnologias surgindo o tempo todo. Mantenha-se curioso e aberto para aprender, e aproveite os recursos, como documentação, tutoriais e fóruns da comunidade, para expandir seus conhecimentos e se manter atualizado com os últimos desenvolvimentos. - -5. **Desenvolvendo uma mentalidade de crescimento**: abrace os desafios e oportunidades que surgem com a colaboração de open source. Adote uma mentalidade de crescimento, que se concentra em aprendizado, melhoria e resiliência. Ao ver os obstáculos como oportunidades de crescimento, você estará mais bem equipado para navegar no complexo mundo do open source e alcançar o sucesso em suas contribuições. - -## Estrutura do curso - -Este curso é dividido em vários capítulos, cada um projetado para cobrir um aspecto específico da colaboração de open source: - -1. **Introdução:** Começaremos preparando o cenário para sua jornada de open source, discutindo pré-requisitos, objetivos e expectativas. -2. **O que é open source?:** Neste capítulo, exploraremos a definição de open source e sua história, fornecendo uma base sólida para entender o contexto da colaboração de open source. -3. **Por que open source?:** Vamos mergulhar nos benefícios do open source, incluindo acesso ao conhecimento, comunidade e desenvolvimento de habilidades. -4. **Ferramentas para ter sucesso:** Este capítulo apresentará as ferramentas essenciais para uma colaboração de open source bem-sucedida, incluindo GitHub, Git, CodeSee, VS Code e Discord. -5. **Como contribuir para o open source:** Neste capítulo, discutiremos o processo de encontrar projetos para trabalhar, enviar contribuições, embarcar em um novo projeto e o que esperar depois que sua contribuição for enviada. -6. **O segredo do sauce:** Este capítulo revelará as estratégias e técnicas para começar, ganhar tração em suas contribuições, -7. **Conclusão:** Encerraremos o curso com as principais conclusões e discutiremos os próximos passos em sua jornada de open source. - -Ao longo deste curso, forneceremos exemplos e demonstrações para ajudar a ilustrar conceitos-chave e fornecer oportunidades práticas de prática. Quando possível, apresentaremos projetos e ferramentas de open source do mundo real, como [OpenSauced](https://opensauced.pizza/), para demonstrar como aplicar as habilidades que você aprendeu. - -Por favor, note que enquanto esses exemplos e demonstrações são projetados para fornecer orientação e inspiração, sua própria jornada de open source pode ser diferente, dependendo de seus interesses, habilidades e projetos escolhidos. - -Usar os exemplos e demos como ponto de partida, mas não tenha medo de explorar outros projetos, ferramentas e recursos à medida que você continua a aprender e crescer. - -## LFG 🚀 - -Agora que nos apresentamos, é hora de embarcar em sua jornada de open source! No próximo capítulo, mergulharemos na definição de open source e exploraremos sua história, preparando o cenário para uma compreensão mais profunda da colaboração de open source. Vamos começar! - -[Próximo Capítulo ->](./02-what-is-open-source.md) \ No newline at end of file diff --git a/translations/pt-br/06-o-segredo-do sauce.md b/translations/pt-br/06-o-segredo-do sauce.md deleted file mode 100644 index a8bfecfa..00000000 --- a/translations/pt-br/06-o-segredo-do sauce.md +++ /dev/null @@ -1,81 +0,0 @@ -# O segredo do sauce - - -Neste capítulo, vamos compartilhar algumas estratégias e dicas menos conhecidas para causar um impacto duradouro na comunidade de código aberto. Discutiremos como focar em issues abertos, ganhar tração em suas contribuições e desenvolver seu currículo de código aberto usando o OpenSauced. - -## Isues abertos, mais do que PRs que corrigem erros de digitação - - -Enquanto corrigir erros de digitação e melhorar a documentação são contribuições valiosas para projetos de código aberto, é essencial olhar além desses frutos de baixo nível e focar na resolução de issues abertos. Abordar issues abertos não apenas ajuda o projeto a avançar, mas também permite que você desenvolva uma compreensão mais profunda da base de código e demonstre suas habilidades de resolução de issues. - -Aqui estão algumas dicas para encontrar e resolver abrir issues: - - -1. **Navegue no rastreador de issues**: A maioria dos projetos de código aberto usa um rastreador de issues para gerenciar bugs, solicitações de recursos e outras tarefas. Navegue no rastreador de issues para encontrar issues que se alinhem com seus interesses e habilidades. - -2. **Procure por issues amigáveis para iniciantes**: Muitos projetos usam rótulos como "bom primeiro issue" ou "ajuda desejada" para indicar issues que são adequados para iniciantes. Comece com esses issues para construir sua confiança e ganhar experiência antes de abordar tarefas mais complexas. - -3. **Entenda a issue**: Antes de mergulhar em uma issue, certifique-se de entender o problema e o resultado desejado. Se você não tiver certeza de algo, faça perguntas ou peça esclarecimentos aos mantenedores do projeto ou a outros colaboradores. - -4. **Comunique suas intenções**: Antes de começar a trabalhar em uma issue, informe aos mantenedores do projeto e a outros colaboradores que você está interessado em abordá-la. Isso pode ajudar a evitar esforços duplicados e garantir que todos estejam na mesma página. - -5. **Teste suas alterações**: Depois de abordar uma issue, teste suas alterações minuciosamente para garantir que funcionem conforme o esperado e não introduzam novos problemas. - -Ao se concentrar em issues abertas em vez de apenas corrigir erros de digitação, você terá um impacto maior nos projetos aos quais contribui e demonstrará seu compromisso com a comunidade de código aberto. - -## Ganhar tração em suas contribuições - -Enquanto você ganha mais experiência em contribuições de código aberto, pode querer aumentar seu impacto nos projetos em que trabalha e ganhar reconhecimento por seus esforços. Aqui estão algumas estratégias para ganhar tração em suas contribuições: - -1. **Torne-se um colaborador regular**: Contribua consistentemente para os mesmos projetos ao longo do tempo. Isso ajudará você a desenvolver uma compreensão mais profunda da base de código, construir relacionamentos com outros colaboradores e se estabelecer como um membro valioso da comunidade. - -2. **Assuma tarefas desafiadoras**: À medida que você ganha experiência, aborde issues e recursos mais complexos. Isso não apenas ajudará você a crescer como desenvolvedor, mas também demonstrará sua capacidade de lidar com tarefas desafiadoras e contribuir significativamente para o projeto. - -3. **Colabore com os outros**: O código aberto é tudo sobre colaboração. Trabalhe com outros colaboradores para resolver issues, desenvolver recursos e compartilhar conhecimento. Ao colaborar efetivamente, você não apenas melhorará o projeto, mas também construirá uma forte rede de conexões na comunidade de código aberto. - -4. **Compartilhe seu conhecimento**: Compartilhe seu conhecimento e insights escrevendo postagens de blog, criando tutoriais ou dando apresentações sobre os projetos em que trabalha. Isso não apenas ajudará os outros a aprender com suas experiências, mas também o estabelecerá como um líder de pensamento na comunidade de código aberto. - - -5. **Mentore novos colaboradores**: À medida que você ganha mais experiência em contribuições de código aberto, considere orientar novos colaboradores que estão começando sua jornada de código aberto. Isso pode ajudá-lo a retribuir à comunidade, desenvolver suas habilidades de liderança e construir uma reputação positiva. - -## Desenvolva seu currículo de código aberto - -Construir um currículo de código aberto forte pode ajudá-lo a demonstrar suas habilidades, experiência e contribuições para potenciais empregadores, colaboradores e a comunidade de desenvolvedores em geral. O OpenSauced é uma excelente ferramenta para rastrear suas contribuições de código aberto e desenvolver seu currículo de código aberto. Vamos ver como você pode usar o OpenSauced para apoiar sua jornada de código aberto. - -1. **Inscreva-se em uma conta OpenSauced**: se você ainda não criou uma conta, visite [opensauced.pizza](https://opensauced.pizza/) e inscreva-se em uma conta usando suas credenciais do GitHub. - -2. **Visite sua página de perfil público**: Depois de se inscrever, uma página de perfil público será criada para você. Esta página exibirá suas informações de perfil do GitHub e uma lista de suas contribuições de código aberto. Você pode navegar até ela clicando em seu nome de usuário no canto superior direito da página. - -3. **Construa seu currículo de código aberto**: A partir daqui, você poderá adicionar destaques a Pull Requests e Issues que você contribuiu. Você também pode adicionar uma descrição e links ao seu currículo de código aberto. Eles serão agregados em uma única página que você pode compartilhar com outras pessoas, bem como um resumo de suas contribuições que será exibido em sua página de perfil público. - -Vamos mostrar nossa contribuição para o guestbook do capítulo anterior! Em seu perfil, você verá uma seção "Destaques" com uma entrada de texto. Quando você clica nisso, você pode adicionar um título, alguns pensamentos e um link para o seu PR. Isso será exibido em sua página de perfil público. Vamos adicionar um destaque para nossa contribuição para o guestbook. - -## Destacar efetivamente suas contribuições - -Informações importantes a serem incluídas ao destacar suas contribuições: - -- Novo material que você criou; -- Detalhes do projeto (ferramentas, bibliotecas, tamanho e complexidade); -- O tipo de suas contribuições: correção de bugs, recurso, desempenho, documentação, etc.; -- Os detalhes de sua contribuição, incluindo melhorias e impactos feitos no projeto e na comunidade; -- Detalhes de colaboração e trabalho em equipe; - -### Formatar seu destaque - -Para ser mais eficaz ao destacar suas contribuições, recomendamos o uso do seguinte formato: - -- **Título**: Este deve ser uma breve descrição da contribuição. Por exemplo, "Criei uma ação do GitHub para mesclar automaticamente pull requests". -- **Link** -- **Descrição**: quando você destaca sua contribuição, recomendamos mencionar o impacto que ela teve no projeto geral. Isso seria útil para destacar suas qualificações para cargos de emprego, especialmente se você tiver lacunas de emprego. Considere usar o seguinte modelo para ajudá-lo a transformar esse destaque em uma história: - - Verbo de sucesso + substantivo + métrica + resultado. - - Exemplo: Enquanto eu estava revisando alguns pull requests para o GirlScript Summer of Code deste ano, notei que a maioria deles não seria mesclada, apesar de eu e o proprietário darmos aprovações. Então, **criei uma ação do GitHub onde os pull requests são mesclados automaticamente assim que passam pelas etapas de implantação (verbo + substantivo sucessivo)**, o que **aumentou as taxas de produtividade em 80% (métrica + resultado).** - -![Adicionando um destaque ao seu perfil](../../opensauced-highlights.png) - -**Compartilhe!**: Depois de construir um portfólio de contribuições de código aberto, você pode compartilhar seu currículo de código aberto com outras pessoas clicando no botão de compartilhamento no cabeçalho de sua página de perfil. Isso pode ser especialmente útil ao se candidatar a empregos, fazer networking com outros desenvolvedores ou promover seu trabalho na comunidade de código aberto. - -Ao alavancar o OpenSauced para rastrear suas contribuições de código aberto e desenvolver seu currículo, você estará mais bem equipado para mostrar suas habilidades, experiência e impacto na comunidade de código aberto. - -Para concluir, começar a contribuir para o código aberto e causar um impacto duradouro nos projetos em que você trabalha requer uma combinação de habilidades técnicas, colaboração e persistência. Ao se concentrar em issues abertas, ganhar tração em suas contribuições e alavancar ferramentas como OpenSauced, você estará bem encaminhado para uma jornada de código aberto bem-sucedida e gratificante. - -[Último Capítulo ->](./07-conclusion.md) From 4b8fc29f0037a399c08dd54a5c1a5235205e6845 Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Thu, 21 Sep 2023 20:17:41 -0400 Subject: [PATCH 05/62] feat: adding files back --- translations/fr/pt-br/_layouts/sidebar.md | 10 +++++ translations/pt-br/README.pt.md | 53 ----------------------- 2 files changed, 10 insertions(+), 53 deletions(-) create mode 100644 translations/fr/pt-br/_layouts/sidebar.md delete mode 100644 translations/pt-br/README.pt.md diff --git a/translations/fr/pt-br/_layouts/sidebar.md b/translations/fr/pt-br/_layouts/sidebar.md new file mode 100644 index 00000000..33833659 --- /dev/null +++ b/translations/fr/pt-br/_layouts/sidebar.md @@ -0,0 +1,10 @@ +- Páginas + - [Introdução](/translations/pt-br/01-introdução.md) + - [O que é Open Source?](/translations/pt-br/02-o-que-é-open-source.md) + - [Por que Open Source?](/translations/pt-br/03-por-que-open-source.md) + - [Ferramentas utilizadas](/translations/pt-br/04-ferramentas-utilizadas.md) + - [Como Contribuir Para Open Source](/translations/pt-br/05-como-contribuir-para-open-source.md) + - [O segredo do sauce](/translations/pt-br/06-o-molho-secreto.md) + - [Conclusão](/translations/pt-br/07-conclusão.md) + - [Recursos Adicionais](/translations/pt-br/08-recursos-adicionais.md) + - [Glossário](/translations/pt-br/09-glossário.md) \ No newline at end of file diff --git a/translations/pt-br/README.pt.md b/translations/pt-br/README.pt.md deleted file mode 100644 index 6ac8bb69..00000000 --- a/translations/pt-br/README.pt.md +++ /dev/null @@ -1,53 +0,0 @@ -
-
- Open Sauced -

🍕 Introdução ao Open Source com OpenSauced 🍕

- O site fornece materiais do curso Introdução ao Open Source com OpenSauced. -
-
- -Bem-vindo ao curso de Introdução ao Open Source com OpenSauced! Este curso foi projetado para fornecer uma introdução ao open source e orientá-lo no processo de contribuição para projetos de código aberto. - -## Suporte de idioma - -- [English](../../README.md) - -## Visão geral do curso - -O curso é dividido em cinco capítulos, cada um cobrindo um aspecto diferente do open source: - -1. **O que é open source?** Este capítulo fornece uma introdução ao open source, sua história e sua importância no cenário atual de desenvolvimento de software. - -2. **Por que open source?** Neste capítulo, você aprenderá sobre os benefícios do software open source, como colaboração aumentada, desenvolvimento mais rápido e qualidade aprimorada. - -3. **Ferramentas para ter sucesso.** Descubra as principais ferramentas e plataformas necessárias para uma jornada de sucesso no desenvolvimento de código aberto. Do Git e GitHub para controle de versão e colaboração ao CodeSee para visualização de código e VS Code como seu editor de código, este capítulo fornece uma visão geral de como aproveitar essas ferramentas essenciais. - -4. **Como contribuir para o open source.** -Este capítulo abrange a busca de projetos para trabalhar, o envio de contribuições, a integração em novos projetos e os resultados após o envio de contribuições. As dicas para encontrar projetos incluem navegar no GitHub e GitLab, seguir interesses pessoais, participar de comunidades de código aberto e utilizar plataformas como OpenSauced. - -5. **O molho secreto.** -Este capítulo se concentra em fornecer estratégias e dicas menos conhecidas para causar um impacto duradouro na comunidade de código aberto. Este capítulo fornece estratégias para encontrar problemas, ganhar tração em sua jornada de código aberto e alavancar o OpenSauced para construir seu currículo de código aberto. - -## Informações adicionais - -Este é o início da sua jornada de código aberto, por isso fornecemos alguns recursos adicionais para ajudá-lo a começar: -- [Glossário](/translations/pt-br/09-glossário.md): Um glossário de termos e definições comuns usados no open source. -- [Recursos adicionais](/translations/pt-br/08-recursos-adicionais.md): Uma lista de recursos adicionais para aprender mais sobre open source, incluindo postagens de blog, tutoriais e guias. - -## Começando - -Para começar o curso, basta navegar até o arquivo [`intro`](/translations/pt-br/01-introdução.md) no repositório e começar a ler! Cada capítulo se baseia no anterior, portanto, recomendamos lê-los em ordem. - -Conforme você trabalha no curso, incentivamos você a experimentar as ferramentas e conceitos abordados em cada capítulo. A melhor maneira de aprender é fazendo, portanto, tente contribuir para um projeto de código aberto real ou criar seu próprio projeto do zero! - -## Construindo seu currículo código aberto - -Um dos recursos exclusivos deste curso é que ele fornece orientações sobre como construir seu currículo de código aberto usando o OpenSauced. O OpenSauced é uma plataforma que ajuda você a rastrear e mostrar suas contribuições de código aberto, facilitando a notificação por potenciais empregadores e colaboradores. - -Para saber mais sobre como usar o OpenSauced para construir seu currículo de código aberto, não deixe de conferir a seção `Construindo seu currículo de código aberto` no [Capítulo 6 - O segredo do sauce](./06-the-secret-sauce.md). - -
- -Nós da Open Sauced estamos muito animados para compartilhar este curso com você! Esperamos que você ache este curso informativo e útil! Se você tiver alguma dúvida ou comentário, não hesite em abrir uma issue ou entrar em contato conosco na comunidade OpenSauced Discord. - -Feliz aprendizado e contribuição! From 32a505fb0ed1daa1985c96bd8ce1f95a7269b501 Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Thu, 21 Sep 2023 20:23:40 -0400 Subject: [PATCH 06/62] feat: add navbar again --- translations/fr/pt-br/_layouts/navbar.md | 5 +++++ translations/fr/pt-br/_layouts/sidebar.md | 10 ---------- 2 files changed, 5 insertions(+), 10 deletions(-) create mode 100644 translations/fr/pt-br/_layouts/navbar.md delete mode 100644 translations/fr/pt-br/_layouts/sidebar.md diff --git a/translations/fr/pt-br/_layouts/navbar.md b/translations/fr/pt-br/_layouts/navbar.md new file mode 100644 index 00000000..e406a670 --- /dev/null +++ b/translations/fr/pt-br/_layouts/navbar.md @@ -0,0 +1,5 @@ +* [Home Page](/) +* [⭐ Star The Repo](https://github.com/open-sauced/intro) +* Languages + * [:us: English](/) + * [:br🇧🇷: Português](/translations/pt-br/README.pt.md) \ No newline at end of file diff --git a/translations/fr/pt-br/_layouts/sidebar.md b/translations/fr/pt-br/_layouts/sidebar.md deleted file mode 100644 index 33833659..00000000 --- a/translations/fr/pt-br/_layouts/sidebar.md +++ /dev/null @@ -1,10 +0,0 @@ -- Páginas - - [Introdução](/translations/pt-br/01-introdução.md) - - [O que é Open Source?](/translations/pt-br/02-o-que-é-open-source.md) - - [Por que Open Source?](/translations/pt-br/03-por-que-open-source.md) - - [Ferramentas utilizadas](/translations/pt-br/04-ferramentas-utilizadas.md) - - [Como Contribuir Para Open Source](/translations/pt-br/05-como-contribuir-para-open-source.md) - - [O segredo do sauce](/translations/pt-br/06-o-molho-secreto.md) - - [Conclusão](/translations/pt-br/07-conclusão.md) - - [Recursos Adicionais](/translations/pt-br/08-recursos-adicionais.md) - - [Glossário](/translations/pt-br/09-glossário.md) \ No newline at end of file From 09aeebd28bf83bad0ad22202fe7d1deb02425b2b Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Thu, 21 Sep 2023 20:32:06 -0400 Subject: [PATCH 07/62] fix: adding all translations --- .../fr/pt-br/01-introdu\303\247\303\243o.md" | 67 +++++++++ .../pt-br/02-o-que-\303\251-open-source.md" | 69 +++++++++ .../fr/pt-br/03-por-que-open-source.md | 57 ++++++++ .../fr/pt-br/04-ferramentas-utilizadas.md | 138 ++++++++++++++++++ .../05-como-contribuir-para-open-source.md | 28 ++++ .../fr/pt-br/06-o-segredo-do sauce.md | 81 ++++++++++ .../fr/pt-br/07-conclus\303\243o.md" | 39 +++++ .../fr/pt-br/08-recursos-adicionais.md | 25 ++++ .../fr/pt-br/09-gloss\303\241rio.md" | 88 +++++++++++ translations/fr/pt-br/README.pt.md | 57 ++++++++ translations/fr/pt-br/_layouts/sidebar.md | 10 ++ 11 files changed, 659 insertions(+) create mode 100644 "translations/fr/pt-br/01-introdu\303\247\303\243o.md" create mode 100644 "translations/fr/pt-br/02-o-que-\303\251-open-source.md" create mode 100644 translations/fr/pt-br/03-por-que-open-source.md create mode 100644 translations/fr/pt-br/04-ferramentas-utilizadas.md create mode 100644 translations/fr/pt-br/05-como-contribuir-para-open-source.md create mode 100644 translations/fr/pt-br/06-o-segredo-do sauce.md create mode 100644 "translations/fr/pt-br/07-conclus\303\243o.md" create mode 100644 translations/fr/pt-br/08-recursos-adicionais.md create mode 100644 "translations/fr/pt-br/09-gloss\303\241rio.md" create mode 100644 translations/fr/pt-br/README.pt.md create mode 100644 translations/fr/pt-br/_layouts/sidebar.md diff --git "a/translations/fr/pt-br/01-introdu\303\247\303\243o.md" "b/translations/fr/pt-br/01-introdu\303\247\303\243o.md" new file mode 100644 index 00000000..bf8b3a8c --- /dev/null +++ "b/translations/fr/pt-br/01-introdu\303\247\303\243o.md" @@ -0,0 +1,67 @@ +# Introdução + +Bem-vindo ao curso "Getting Started with Open Source"! +Este curso abrangente irá guiá-lo pelo fascinante mundo do open source e ajudá-lo a se tornar um colaborador ativo. +Ao final deste curso, você deve ter uma compreensão sólida de como encontrar, participar e contribuir para projetos de open source, bem como como desenvolver seu currículo de open source. +Mas primeiro, vamos preparar o cenário discutindo os pré-requisitos, objetivos e expectativas para este curso. + +## Pré-requisitos + +Antes de mergulhar no mundo do open source, é essencial ter uma compreensão básica dos conceitos de programação e alguma experiência trabalhando com código. +Embora o curso forneça exemplos e demonstrações, você obterá o máximo do material se tiver algum conhecimento prévio. + +Além disso, este curso pressupõe que você esteja familiarizado com o Git e o GitHub. +O Git é um sistema de controle de versão amplamente utilizado, e o GitHub é uma plataforma popular para hospedar e colaborar em repositórios Git. + +Se você ainda não está familiarizado com o Git e o GitHub, recomendamos que você reserve um tempo para aprender o básico antes de iniciar este curso. + +## Objetivos + +Ao longo deste curso, nossos principais objetivos são ajudá-lo a: + +1. **Entender o open source e seus benefícios**: exploraremos o conceito de open source, sua história e as inúmeras vantagens de contribuir para projetos de open source. +2. **Aprenda a encontrar projetos de open source**: descobrir projetos que se alinham com seus interesses e habilidades é crucial para uma experiência de open source gratificante. Apresentaremos a você ferramentas e técnicas para encontrar projetos para contribuir. +3. **Dominar as ferramentas e processos para contribuir**: forneceremos uma visão geral das ferramentas e processos essenciais para uma colaboração de open source bem-sucedida, como controle de versão, revisão de código e plataformas de comunicação. +4. **Adquira experiência prática**: seguindo exemplos e demonstrações, você terá a oportunidade de praticar suas habilidades e ganhar confiança em sua capacidade de contribuir para projetos de open source. +5. **Desenvolva seu currículo de open source**: mostrar suas contribuições de open source é vital para construir sua reputação na comunidade e demonstrar sua experiência para potenciais empregadores ou clientes. Discutiremos estratégias para desenvolver e manter seu currículo de open source. + +## Expectativas + +Este curso foi projetado para fornecer uma base sólida em colaboração de open source. +Embora cubramos uma variedade de tópicos e forneçamos exemplos, demonstrações e oportunidades para prática, é essencial ter expectativas realistas sobre o que você pode alcançar durante o curso. + +1. **A prática é crucial**: aprender sobre open source é apenas o começo; para se tornar um colaborador proficiente, você precisará praticar consistentemente. +Tenha em mente que quanto mais você contribuir para projetos de open source, mais aprenderá e crescerá como desenvolvedor. + +2. **A paciência é fundamental**: tornar-se proficiente em colaboração de open source leva tempo e esforço. Não se desanime se encontrar desafios ao longo do caminho; lembre-se de que toda contribuição, por menor que seja, é valiosa e ajuda a melhorar o projeto. + +3. **Engajamento com a comunidade**: o open source é mais do que apenas código; trata-se das pessoas que colaboram e contribuem para projetos. Engaje-se com a comunidade fazendo perguntas, compartilhando seu conhecimento e apoiando os outros. +Construir relacionamentos com outros colaboradores aprimorará sua experiência de open source e ajudará você a crescer como desenvolvedor. + +4. **Aprendizado contínuo**: o open source é um campo em rápida evolução, com novos projetos, ferramentas e tecnologias surgindo o tempo todo. Mantenha-se curioso e aberto para aprender, e aproveite os recursos, como documentação, tutoriais e fóruns da comunidade, para expandir seus conhecimentos e se manter atualizado com os últimos desenvolvimentos. + +5. **Desenvolvendo uma mentalidade de crescimento**: abrace os desafios e oportunidades que surgem com a colaboração de open source. Adote uma mentalidade de crescimento, que se concentra em aprendizado, melhoria e resiliência. Ao ver os obstáculos como oportunidades de crescimento, você estará mais bem equipado para navegar no complexo mundo do open source e alcançar o sucesso em suas contribuições. + +## Estrutura do curso + +Este curso é dividido em vários capítulos, cada um projetado para cobrir um aspecto específico da colaboração de open source: + +1. **Introdução:** Começaremos preparando o cenário para sua jornada de open source, discutindo pré-requisitos, objetivos e expectativas. +2. **O que é open source?:** Neste capítulo, exploraremos a definição de open source e sua história, fornecendo uma base sólida para entender o contexto da colaboração de open source. +3. **Por que open source?:** Vamos mergulhar nos benefícios do open source, incluindo acesso ao conhecimento, comunidade e desenvolvimento de habilidades. +4. **Ferramentas para ter sucesso:** Este capítulo apresentará as ferramentas essenciais para uma colaboração de open source bem-sucedida, incluindo GitHub, Git, CodeSee, VS Code e Discord. +5. **Como contribuir para o open source:** Neste capítulo, discutiremos o processo de encontrar projetos para trabalhar, enviar contribuições, embarcar em um novo projeto e o que esperar depois que sua contribuição for enviada. +6. **O segredo do sauce:** Este capítulo revelará as estratégias e técnicas para começar, ganhar tração em suas contribuições, +7. **Conclusão:** Encerraremos o curso com as principais conclusões e discutiremos os próximos passos em sua jornada de open source. + +Ao longo deste curso, forneceremos exemplos e demonstrações para ajudar a ilustrar conceitos-chave e fornecer oportunidades práticas de prática. Quando possível, apresentaremos projetos e ferramentas de open source do mundo real, como [OpenSauced](https://opensauced.pizza/), para demonstrar como aplicar as habilidades que você aprendeu. + +Por favor, note que enquanto esses exemplos e demonstrações são projetados para fornecer orientação e inspiração, sua própria jornada de open source pode ser diferente, dependendo de seus interesses, habilidades e projetos escolhidos. + +Usar os exemplos e demos como ponto de partida, mas não tenha medo de explorar outros projetos, ferramentas e recursos à medida que você continua a aprender e crescer. + +## LFG 🚀 + +Agora que nos apresentamos, é hora de embarcar em sua jornada de open source! No próximo capítulo, mergulharemos na definição de open source e exploraremos sua história, preparando o cenário para uma compreensão mais profunda da colaboração de open source. Vamos começar! + +[Próximo Capítulo ->](./02-what-is-open-source.md) \ No newline at end of file diff --git "a/translations/fr/pt-br/02-o-que-\303\251-open-source.md" "b/translations/fr/pt-br/02-o-que-\303\251-open-source.md" new file mode 100644 index 00000000..22d2f1d4 --- /dev/null +++ "b/translations/fr/pt-br/02-o-que-\303\251-open-source.md" @@ -0,0 +1,69 @@ +# O que é Open Source? + +Neste capítulo, vamos mergulhar no conceito de código aberto, sua definição e sua história. Obter uma compreensão profunda do código aberto ajudará você a apreciar o contexto em que estará a colaborar e contribuindo. + +## Definição + +O termo "código aberto" refere-se a um tipo de software cujo código-fonte é disponibilizado ao público, permitindo que qualquer pessoa visualize, use, modifique e distribua o código. Isso é em contraste com o software proprietário, onde o código-fonte é mantido em segredo e apenas o programa compilado é distribuído. O princípio básico por trás do código aberto é a ideia de colaboração e a crença de que o compartilhamento de conhecimento e recursos leva a um software melhor, mais confiável e mais inovador. + +Um software de código aberto é construído com base na premissa de que, quando muitas pessoas trabalham juntas, elas podem criar algo maior do que a soma das suas partes. Os contribuidores para projetos de código aberto vêm de origens diversas e trazem uma ampla gama de habilidades, experiências e perspetivas para a mesa. Essa diversidade de pensamento e experiência leva a um software mais robusto, inovador e confiável. + +### Licenças de código aberto + +Para que um software seja considerado de código aberto, ele deve ser lançado sob uma licença que conceda aos usuários o direito de acessar, modificar e distribuir o código-fonte. Existem inúmeras licenças de código aberto disponíveis, cada uma com o seu próprio conjunto de termos e condições. Algumas licenças de código aberto populares incluem a Licença MIT, a Licença Pública Geral GNU (GPL) e a Licença Apache. + +Essas licenças são cruciais porque garantem que o software permaneça aberto e acessível a todos. Ao conceder aos usuários o direito de visualizar, modificar e distribuir o código, as licenças de código aberto promovem uma cultura de colaboração, inovação e conhecimento compartilhado. + +## História breve do código aberto + +A ideia de compartilhar livremente conhecimento e recursos existe há séculos, mas o movimento de código aberto como o conhecemos hoje pode ser rastreado aos primeiros dias da computação. + +### Primeiros aparecimentos + +Nos anos 50 e 60, o software de computador era frequentemente agrupado com hardware, e o código-fonte era compartilhado livremente entre pesquisadores e desenvolvedores. Durante esse período, era comum que os programadores colaborassem, compartilhassem ideias e modificassem o código uns dos outros para melhorar e inovar. + +No entanto, na década de 1970, à medida que a indústria de software começou a crescer e a comercializar, as empresas começaram a ver o software como um ativo e começaram a restringir o acesso ao código-fonte. Essa mudança marcou o início da divisão entre software proprietário e o emergente movimento de código aberto. + +### O nascimento do software livre + +Como consequência da crescente restrição ao acesso ao código-fonte, o programador Richard Stallman fundou a Free Software Foundation (FSF) em 1985. O objetivo da FSF era promover o desenvolvimento e o uso de software livre, que eles definiram como software que concede aos usuários a liberdade de executar, estudar, compartilhar e modificar o código. Esse conceito é semelhante ao código aberto, mas enfatiza mais os aspectos éticos e políticos da liberdade de software. + +Stallman e a FSF passaram a desenvolver o Projeto GNU (que significa "GNU's Not Unix"), um esforço ambicioso para criar um sistema operativo completamente livre e aberto. Embora o Projeto GNU tenha fornecido muitos componentes essenciais, faltava uma peça crítica: um kernel livre e aberto, o componente central de um sistema operativo. + +### O surgimento do Linux + +Em 1991, um estudante finlandês de ciência da computação chamado Linus Torvalds desenvolveu um kernel livre e aberto chamado Linux. Quando combinado com o sistema GNU, o Linux formou um sistema operacional completo, livre e de código aberto que ainda é amplamente utilizado hoje. O sucesso do Linux ajudou a popularizar o conceito de código aberto e desencadeou uma onda de novos projetos, ferramentas e tecnologias. + +### A Iniciativa de Código Aberto(Open Source Initiative, abreviada OSI) + +Em 1998, Christine Peterson, diretora-executiva da Foresight, cunhou o termo "software de código aberto" como um [esforço deliberado para tornar este campo... mais compreensível para novatos e para negócios](https://opensource.com/article/18/2/coining-term-open-source-software). Ela, com Eric S. Raymond, Bruce Perens e outros desenvolvedores e defensores, criou então a Iniciativa de Código Aberto (Open Source Initiative, OSI) para espalhar mais conscientização sobre esse conceito. A partir daí, a OSI desenvolveu a definição de código aberto, um conjunto de critérios que o software deve atender para ser considerado de código aberto. Esses critérios incluem distribuição gratuita, disponibilidade de código-fonte, trabalhos derivados e integridade da licença. + +A OSI também criou a Licença de Código Aberto (Open Source License, OSL), uma licença de software que atende aos critérios de código aberto. A OSL foi posteriormente renomeada para Licença Pública Geral GNU (GPL), que é uma das licenças de código aberto mais populares e amplamente utilizadas. + +### O crescimento das comunidades de código aberto + +À medida que o movimento de código aberto ganhava força, inúmeras comunidades e plataformas surgiram para facilitar a colaboração e o compartilhamento de conhecimento. Alguns exemplos notáveis incluem: + +- **SourceForge**: Lançado em 1999, o SourceForge foi uma das primeiras plataformas baseadas na web a fornecer ferramentas e recursos para que os desenvolvedores colaborassem em projetos de código aberto. No auge, o SourceForge hospedava milhares de projetos e atraía milhões de usuários. +- **GitHub**: Fundado em 2008, o GitHub rapidamente se tornou a plataforma padrão para hospedar e colaborar em repositórios Git. Hoje, o GitHub é o lar de milhões de projetos de código aberto e possui uma comunidade vibrante de colaboradores de todo o mundo. +- **GitLab**: Lançado em 2011 como uma alternativa de código aberto ao GitHub, o GitLab oferece um conjunto de ferramentas e recursos para gerir repositórios Git, rastrear problemas e facilitar a colaboração. + +Essas plataformas desempenharam um papel crucial no fomento ao crescimento das comunidades de código aberto e na facilitação da contribuição e colaboração de desenvolvedores em projetos. + +### O crescimento do envolvimento corporativo + +Nos últimos anos, houve um aumento significativo do envolvimento corporativo em projetos de código aberto. Muitas empresas agora reconhecem o valor do código aberto e contribuem ativamente e apoiam vários projetos. Algumas empresas até foram tão longe a ponto de abrir seus próprios ferramentas e tecnologias internas, como o TensorFlow do Google e o React do Facebook. + +Este aumento do envolvimento corporativo não só levou a mais recursos e suporte para projetos de código aberto, mas também ajudou a legitimar o movimento de código aberto e incentivar uma adoção mais ampla. + +### A evolução do código aberto + +O movimento de código aberto percorreu um longo caminho desde os seus primórdios. Hoje, o software de código aberto está em toda parte, alimentando desde sites e aplicativos móveis até algoritmos de inteligência artificial e aprendizado de máquina. + +À medida que o código aberto continua a evoluir, novos projetos, ferramentas e tecnologias estão constantemente surgindo, empurrando os limites do que é possível e impulsionando a inovação em uma ampla gama de indústrias. + +O crescente interesse e adoção do código aberto também levaram a ecossistema de código aberto próspero de conferências, meetups e comunidades online onde os desenvolvedores podem se reunir para aprender, colaborar e compartilhar os seus conhecimentos. Ao participar desses eventos e se envolver com a comunidade de código aberto, você terá a oportunidade de expandir as suas habilidades, construir a sua rede e se manter atualizado com os últimos desenvolvimentos na �rea. + +No próximo capítulo, exploraremos os muitos benefícios de contribuir para projetos de código aberto e discutiremos como a colaboração de código aberto pode ajudá-lo a acessar conhecimento, se conectar com uma comunidade e desenvolver habilidades valiosas. + +[Próximo Capítulo ->](/translations/pt-br/03-por-que-open-source.md) \ No newline at end of file diff --git a/translations/fr/pt-br/03-por-que-open-source.md b/translations/fr/pt-br/03-por-que-open-source.md new file mode 100644 index 00000000..26a08c1f --- /dev/null +++ b/translations/fr/pt-br/03-por-que-open-source.md @@ -0,0 +1,57 @@ +# Por que Open Source? + +Na seção anterior, exploramos o conceito de código aberto e sua história. Agora, vamos nos aprofundar nos muitos benefícios de contribuir para projetos de código aberto. Ao entender as vantagens da colaboração de código aberto, você estará mais bem equipado para aproveitar as oportunidades que ela apresenta e aproveitar ao máximo sua jornada de código aberto. + +## Acesso ao conhecimento + +Um dos principais benefícios de contribuir para projetos de código aberto é a oportunidade de acessar uma riqueza de conhecimento e recursos. Como contribuidor de código aberto, você poderá: + +1. **Aprenda com projetos reais**: Projetos de código aberto oferecem uma oportunidade única de estudar e aprender com bases de código do mundo real. Ao examinar como outros desenvolvedores enfrentaram problemas complexos, você pode obter insights sobre as melhores práticas, padrões de design e técnicas de ponta que pode aplicar aos seus próprios projetos. + +2. **Acesse perspetivas diversas**: Projetos de código aberto atraem contribuidores de todo o mundo, cada um trazendo seu próprio conjunto único de habilidades, experiências e perspectivas. Ao colaborar com outras pessoas, você pode ampliar sua compreensão de diferentes tecnologias, linguagens de programação e metodologias de desenvolvimento. + +3. **Mantenha-se atualizado com as últimas tendências**: A comunidade de código aberto geralmente está na vanguarda da inovação, com novos projetos, ferramentas e tecnologias constantemente surgindo. Ao participar de projetos de código aberto, você pode se manter atualizado com os últimos desenvolvimentos em sua área e aprender sobre tendências emergentes e melhores práticas. + +4. **Acesse recursos de alta qualidade**: A comunidade de código aberto é conhecida por seu compromisso em produzir documentação, tutoriais e outros recursos educacionais de alta qualidade. Ao aproveitar essa riqueza de conhecimento, você pode aprofundar sua compreensão de várias tecnologias e conceitos e continuar a crescer como desenvolvedor. + +## Acesso à comunidade + +A comunidade de código aberto é uma rede diversificada e global de desenvolvedores, entusiastas e defensores que compartilham uma paixão comum pela colaboração e compartilhamento de conhecimento. Ao contribuir para projetos de código aberto, você pode: + +1. **Conecte-se com pessoas com ideias semelhantes**: projetos de código aberto oferecem uma oportunidade de colaborar com outras pessoas que compartilham os seus interesses e paixões. Trabalhando juntos, você pode formar conexões e amizades duradouras que podem enriquecer sua vida pessoal e profissional. + +2. **Expanda a sua rede**: A comunidade de código aberto é vasta e interconectada, com inúmeros projetos, eventos e fóruns onde os desenvolvedores se reúnem para colaborar e compartilhar conhecimento. Ao participar dessas atividades, você pode expandir sua rede profissional e se conectar com potenciais mentores, colaboradores e até empregadores. + +3. **Desenvolva habilidades de comunicação e colaboração**: trabalhar em projetos de código aberto geralmente envolve colaborar com outras pessoas, remota ou pessoalmente. Isso pode ajudá-lo a desenvolver habilidades essenciais de comunicação e colaboração, como fornecer feedback construtivo, resolver conflitos e trabalhar efetivamente em equipe. + +4. **Retribua à comunidade**: Contribuir para projetos de código aberto é uma maneira de retribuir à comunidade que lhe forneceu conhecimento e recursos valiosos. Compartilhando as suas habilidades e experiência, você pode ajudar a apoiar o crescimento e o sucesso contínuo do movimento de código aberto. + +## Acesso a habilidades + +Contribuir para projetos de código aberto pode ajudá-lo a desenvolver uma ampla gama de habilidades técnicas e não técnicas altamente valorizadas no mercado de trabalho. Como contribuidor de código aberto, você terá a oportunidade de: + +1. **Melhore as suas habilidades de programação**: Trabalhar em projetos reais é uma excelente maneira de melhorar as suas habilidades de programação e aprofundar a sua compreensão de várias tecnologias e linguagens. Ao enfrentar problemas desafiadores e aprender com outros contribuidores, você pode refinar suas habilidades e se tornar um desenvolvedor mais proficiente. + +2. **Adquira experiência com novas tecnologias**: Projetos de código aberto geralmente envolvem tecnologias e ferramentas de ponta que podem não ser usadas no seu trabalho ou estudos diários. Ao contribuir para esses projetos, você pode obter experiência prática com novas tecnologias e ampliar seu conjunto de habilidades. + +3. **Construa o seu portfólio**: Contribuir para projetos de código aberto permite que você crie um registro público do seu trabalho, mostrando as suas habilidades e experiência para potenciais empregadores. Um portfólio forte de contribuições de código aberto pode ajudá-lo a se destacar no mercado de trabalho e demonstrar seu compromisso com a aprendizagem contínua e o crescimento profissional. + +4. **Desenvolva habilidades de resolução de problemas e pensamento crítico**: trabalhar em projetos de código aberto geralmente envolve enfrentar problemas complexos e tomar decisões importantes. Ao navegar nesses desafios, você pode desenvolver habilidades valiosas de resolução de problemas e pensamento crítico que podem ser aplicadas a vários aspectos de sua vida e carreira. + +5. **Aprenda gerenciamento e organização de projetos**: contribuir para projetos de código aberto pode expô-lo a vários aspetos do gerenciamento e organização de projetos, como planejamento, documentação e controle de versão. Ao aprender a gerenciar projetos de código aberto, você pode desenvolver habilidades que podem ser aplicadas a projetos pessoais e profissionais. + +6. **Desenvolva habilidades de liderança e mentoria**: ao ganhar experiência na comunidade de código aberto, você pode se encontrar numa posição para orientar e orientar novos contribuidores. Ao assumir esses papéis de liderança, você pode desenvolver habilidades essenciais, como comunicação, empatia e delegação, que podem ajudá-lo a ter sucesso em sua carreira e vida pessoal. + +## Benefícios adicionais + +Além dos benefícios mencionados acima, contribuir para projetos de código aberto também pode fornecer várias outras vantagens, como: + +1. **Aumento das oportunidades de emprego**: Muitos empregadores valorizam a experiência de código aberto e procuram ativamente candidatos que tenham um histórico comprovado de contribuição para projetos de código aberto. Ao mostrar suas contribuições de código aberto, você pode aumentar suas chances de conseguir o emprego dos seus sonhos ou avançar em sua carreira. + +2. **Crescimento pessoal**: Contribuir para projetos de código aberto pode ser uma experiência gratificante, tanto pessoal quanto profissionalmente. Ao compartilhar suas habilidades e conhecimentos, você pode fazer uma diferença tangível no mundo e contribuir para algo maior que você. + +3. **Oportunidades de reconhecimento**: Projetos de código aberto geralmente atraem a atenção de líderes da indústria, influenciadores e veículos de mídia. Ao fazer contribuições significativas para projetos de alto perfil, você pode ganhar reconhecimento e se estabelecer como um especialista em seu campo. + +No próximo capítulo, discutiremos as ferramentas e recursos essenciais de que você precisará para ter sucesso em sua jornada de código aberto, incluindo GitHub, Git, CodeSee, VS Code e Discord. Ao se familiarizar com essas ferramentas, você estará melhor equipado para colaborar com outras pessoas, gerenciar seus projetos e contribuir efetivamente para projetos de código aberto. + +[Próximo Capítulo -->](./04-tools-to-be-successful.md) \ No newline at end of file diff --git a/translations/fr/pt-br/04-ferramentas-utilizadas.md b/translations/fr/pt-br/04-ferramentas-utilizadas.md new file mode 100644 index 00000000..92fd7d8d --- /dev/null +++ b/translations/fr/pt-br/04-ferramentas-utilizadas.md @@ -0,0 +1,138 @@ +# Ferramentas utilizadas + +Para ter sucesso na sua jornada de código aberto, é essencial familiarizar-se com as ferramentas e plataformas comumente utilizadas pela comunidade. Essas ferramentas ajudarão você a colaborar de forma eficaz, gerenciar seus projetos e contribuir para projetos de código aberto. Neste capítulo, discutiremos as seguintes ferramentas essenciais para colaboração de código aberto: + +- GitHub & Git +- CodeSee +- VS Code (O editor) +- Discord + +## Pré-requisitos + +Antes de completar o seguinte passo a passo, complete o seguinte: +- Crie uma [conta no GitHub](https://github.com/) +- Baixe o [VS Code](https://code.visualstudio.com/) + +## GitHub & Git + +### Introdução ao Git + +Git é um sistema de controlo de versão distribuído projetado para lidar com projetos pequenos e muito grandes com velocidade e eficiência. Foi criado por Linus Torvalds, o criador do kernel Linux, para gerir o desenvolvimento do próprio kernel Linux. + +Git permite que os desenvolvedores acompanhem as alterações no seu código, colaborem com outros desenvolvedores e gerenciem várias versões dos seus projetos. Alguns dos recursos principais do Git incluem: + +- **Ramificação**: Git permite que os desenvolvedores criem ramificações, cópias separadas da sua base de código. Isso permite que eles trabalhem em novos recursos ou correções de bugs sem afetar a base de código principal. Uma vez que as alterações estejam concluídas, eles podem mesclar a ramificação de volta para a base de código principal. +- **Área de preparação**: Git fornece uma área de preparação onde os desenvolvedores podem preparar as suas alterações antes de as comprometerem com o repositório. Isso permite que eles revisem e organizem as suas alterações antes de as tornarem permanentes. +- **Controle de versão distribuído**: Ao contrário dos sistemas de controlo de versão centralizados, o Git é um sistema de controlo de versão distribuído. Isso significa que cada desenvolvedor tem uma cópia completa do repositório na máquina local, permitindo-lhes trabalhar offline e independentemente de um servidor central. + +### Introdução ao GitHub + +O GitHub é uma plataforma baseada na web para controlo de versão e colaboração que utiliza o Git como tecnologia subjacente. Ele fornece uma interface simples e amigável para gerir repositórios Git, bem como uma série de recursos e ferramentas para colaborar com outros desenvolvedores. + +Algumas das principais funcionalidades do GitHub incluem: + +- **Rastramento de issues**: O GitHub fornece um sistema integrado de rastreamento de problemas que permite que os desenvolvedores criem, atribuam e gerenciem problemas relacionados aos seus projetos. Os problemas podem ser categorizados usando etiquetas, marcos e pessoas atribuídas, tornando fácil acompanhar o progresso do projeto e priorizar tarefas. +- **Pull requests**: O GitHub introduz o conceito de pedidos de pull, que permitem que os desenvolvedores proponham alterações à base de código de um projeto. Os pedidos de pull permitem a revisão de código, discussão e colaboração antes que as alterações sejam mescladas na base de código principal. +- **Forking**: O GitHub permite que os utilizadores criem uma cópia de um repositório, conhecida como fork. Isso permite que eles façam alterações na base de código sem afetar o projeto original. Uma vez que as alterações estejam concluídas, eles podem enviar um pedido de pull para que as suas alterações sejam revisadas e potencialmente mescladas na base de código principal. +- **GitHub Actions**: O GitHub Actions é uma poderosa ferramenta de automação que permite criar fluxos de trabalho personalizados para automatizar tarefas como a construção, teste e implantação do seu código. + +### Começando com Git e GitHub + +Para começar com Git e GitHub, siga estes passos: + +1. **Instalar o Git**: Baixe e instale o Git no seu computador visitando o site oficial do Git (https://git-scm.com/) e seguindo as instruções de instalação para o seu sistema operacional. +2. **Configurar o Git**: Após instalar o Git, abra um terminal ou prompt de comando e configure as informações do seu usuário Git executando os seguintes comandos: + +```bash +git config --global user.name "Seu nome" +git config --global user.email "seu.email@exemplo.com" +``` + +Substitua "Seu nome" pelo seu nome completo e "seu.email@exemplo.com" pelo endereço de e-mail que você usou para se inscrever no GitHub. + +#### Praticando Contribuições com o VS Code + +Para praticar o uso do GitHub, vamos passar por criar um repositório, clonar o repositório, fazer alterações e empurrar essas alterações. + +1. **Crie um repositório**: Faça login na sua conta do GitHub e navegue até [https://github.com/new](https://github.com/new) ou clique no ícone "+" no canto superior direito e selecione "Novo repositório" no menu suspenso. + +Escollha você mesmo como o proprietário do repositório, e digite um nome para o seu repositório. Para este exemplo, usaremos `practice-repository` + +![new repo screenshot](../../new-repo.png) + +Escollha se você quer que seja público ou privado. Você também pode escolher inicializar o repositório com um arquivo README, um arquivo .gitignore e/ou uma licença. + +Por exemplo, inicialize o repositório com um arquivo README. + +2. **Clone o repositório**: Uma vez que você tenha criado um repositório, você pode cloná-lo para a sua máquina local executando o seguinte comando no seu terminal ou prompt de comando: + +```bash +git clone https://github.com/username/repository-name.git +``` + +Substitua "username" pelo seu nome de utilizador do GitHub e "repository-name" por `practice-repository`. + +3. **Acesse o seu repositório no seu editor de código**: Para este exemplo, estamos usando o VS Code. Abra o VS Code, navegue até a guia de arquivos e abra o seu `practice-repository`. + +4. **Faça alterações e confirme**: Deve haver um arquivo no seu repositório: `README.md`. Dentro desse arquivo, abaixo de `# practice-repository`, digite 'hello world!' Após ter feito alterações, você pode prepará-las e confirmá-las. + +Abra o seu terminal e certifique-se de que está no diretório correto. Por exemplo, os meus projetos de codificação estão dentro da minha pasta `Projects`. Usando o meu terminal, eu acessaria este repositório executando este comando: + +```bash +cd projects/practice-repository +``` + +Agora que você está no diretório correto, use os seguintes comandos para adicionar as alterações que você fez e escrever uma mensagem de confirmação com uma descrição das alterações: + +```bash +git add . +git commit -m "Your commit message" +``` + +Substitua "Your commit message" por uma breve descrição das alterações que você fez. + +5. **Empurre as suas alterações**: Após confirmar as suas alterações, você pode empurrá-las para o seu repositório remoto no GitHub executando o seguinte comando: + +```bash +git push origin main +``` + +O commando `push origen main` empurra as suas alterações para o ramo "main" do seu repositório remoto. Se você quiser verificar o seu trabalho, navegue até o seu repositório do GitHub. Você deve ver 'hello world!' no seu arquivo README.md. + +Você agora configurou com sucesso o Git e o GitHub na sua máquina local e está pronto para colaborar em projetos de código aberto! + +## CodeSee + +CodeSee é uma poderosa ferramenta de visualização que ajuda os desenvolvedores a entenderem bases de código complexas e a navegarem em grandes projetos de forma mais eficiente. Ao fornecer uma representação visual do seu código, o CodeSee permite que você: + +- **Identificar dependências**: O CodeSee ajuda você a entender como diferentes partes da sua base de código estão conectadas e como as alterações numa área podem afetar outras áreas. +- **Analisar a estrutura do código**: O CodeSee permite que você visualize a estrutura do seu código, facilitando identificar padrões, antipadrões e áreas para melhorias. +- **Navegar em grandes bases de código**: com o CodeSee, você pode navegar rapidamente em grandes bases de código e encontrar as partes do código que você precisa trabalhar. + +Para começar com o CodeSee, visite o site oficial (https://www.codesee.io/) e siga as instruções para instalar a extensão do navegador e integrá-la com a sua conta do GitHub.ub account. + +## VS Code + +Visual Studio Code (VS Code) é um editor de código popular, gratuito e de código aberto desenvolvido pela Microsoft. Ele suporta uma ampla gama de linguagens de programação e oferece muitos recursos que o tornam uma ótima escolha para o desenvolvimento de código aberto, incluindo: + +- **Suporte Git integrado**: O VS Code oferece suporte integrado para Git, permitindo que você gerencie os seus repositórios Git, estágio e confirme alterações e resolva conflitos de mesclagem diretamente do editor. +- **Extensibilidade**: O VS Code oferece um rico ecossistema de extensões que podem aprimorar a sua experiência de desenvolvimento e adicionar suporte para idiomas, ferramentas e estruturas adicionais. +- **Terminal integrado**: O VS Code inclui um terminal integrado que permite executar comandos, scripts e tarefas de compilação diretamente do editor. +- **Customizável**: O VS Code é altamente customizável, permitindo que você adapte o editor às suas preferências e fluxo de trabalho. Você pode personalizar o tema, keybindings e configurações para criar um ambiente de desenvolvimento personalizado. + +Para baixar e instalar o VS Code, visite o site oficial (https://code.visualstudio.com/) e siga as instruções para o seu sistema operativo. + +## Discord + +O Discord é uma plataforma popular de mensagens e chat de voz amplamente utilizada por comunidades de código aberto para comunicação e colaboração. Ao juntar-se a servidor Discord relacionados aos seus interesses e projetos, você pode: + +- **Conecte-se com outros desenvolvedores**: O Discord permite que você converse com outros desenvolvedores, faça perguntas e compartilhe o seu conhecimento com a comunidade. +- **Mantenha-se atualizado**: muitos projetos de código aberto usam o Discord para compartilhar atualizações, anúncios e outras informações importantes. Ao juntar-se aos seus servidores, você pode se manter informado sobre os últimos desenvolvimentos e contribuir de forma mais eficaz. +- **Participar de discussões**: Os servidores do Discord muitas vezes hospedam discussões sobre vários tópicos relacionados ao desenvolvimento de código aberto. Ao participar dessas discussões, você pode aprender com os outros, compartilhar as suas ideias e contribuir para o conhecimento coletivo da comunidade. +- **Encontre oportunidades de colaboração**: Os servidores do Discord podem ser um ótimo lugar para encontrar outras pessoas que compartilham os seus interesses e procuram oportunidades de colaboração. Ao fazer networking com outros desenvolvedores, você pode descobrir novos projetos para trabalhar e formar parcerias valiosas. + +Para começar com o Discord, visite o site oficial (https://discord.com/) e inscreva-se para uma conta. Após ter uma conta, você pode procurar por comunidades e projetos de código aberto em plataformas como GitHub, GitLab ou OpenSauced para encontrar os seus servidores do Discord e juntar-se à conversa. + +Familiarizando-se com essas ferramentas e plataformas, você estará equipado para colaborar efetivamente, gerir os seus projetos e contribuir para projetos de código aberto. No próximo capítulo, discutiremos como contribuir para projetos de código aberto, incluindo encontrar projetos para trabalhar, enviar contribuições e o que acontece depois que a sua contribuição é aceite. + +[Próximo Capítulo ->](/translations/pt-br/05-como-contribuir-para-open-source.md) \ No newline at end of file diff --git a/translations/fr/pt-br/05-como-contribuir-para-open-source.md b/translations/fr/pt-br/05-como-contribuir-para-open-source.md new file mode 100644 index 00000000..d23c5ef8 --- /dev/null +++ b/translations/fr/pt-br/05-como-contribuir-para-open-source.md @@ -0,0 +1,28 @@ +# Como Contribuir Para Open Source + +Neste capítulo, vamos guiá-lo pelo processo de contribuição para projetos de open source. Abordaremos os seguintes tópicos: + +- Encontrar projetos para trabalhar +- Como enviar uma contribuição +- Integração em um novo projeto +- O que acontece depois? + +## Encontrar projetos para trabalhar + +Um dos primeiros desafios que você pode enfrentar ao começar com o código +aberto é encontrar um projeto para o qual contribuir. +Aqui estão algumas dicas para ajudá-lo a descobrir projetos que se alinham com seus interesses e habilidades: + +1. **Navegue no GitHub e no GitLab**: Tanto o GitHub quanto o GitLab hospedam um grande número de projetos de open source. +Você pode usar a funcionalidade de pesquisa para encontrar projetos com base em palavras-chave, linguagens de programação ou tópicos específicos. + +2. **Siga seus interesses**: Pense nas ferramentas, estruturas e bibliotecas que você usa ou sobre as quais tem interesse em aprender mais. Muitos desses projetos são de open source e recebem contribuições da comunidade. + +3. **Junte-se a comunidades de código aberto**: Existem várias comunidades on-line, fóruns e plataformas de bate-papo dedicadas ao desenvolvimento de open source. +Ao ingressar nessas comunidades, você pode se conectar com outros desenvolvedores, descobrir novos projetos e encontrar oportunidades de colaboração. +No [Discord do OpenSauced](https://discord.com/invite/U2peSNf23P), por exemplo, compartilhamos bons primeiros problemas, projetos legais do GitHub e problemas que abrimos em nossos repositórios. + +4. **Aproveite o OpenSauced**: [OpenSauced](https://opensauced.pizza/) é uma plataforma que ajuda os desenvolvedores a descobrir e contribuir com projetos de open source. +Ao usar o OpenSauced, você pode encontrar projetos alinhados com seus interesses, habilidades e objetivos. + +[Próximo Capítulo ->](/translations/pt-br/06-o-molho-secreto.md) \ No newline at end of file diff --git a/translations/fr/pt-br/06-o-segredo-do sauce.md b/translations/fr/pt-br/06-o-segredo-do sauce.md new file mode 100644 index 00000000..7dd811cd --- /dev/null +++ b/translations/fr/pt-br/06-o-segredo-do sauce.md @@ -0,0 +1,81 @@ +# O segredo do sauce + + +Neste capítulo, vamos compartilhar algumas estratégias e dicas menos conhecidas para causar um impacto duradouro na comunidade de código aberto. Discutiremos como focar em issues abertos, ganhar tração em suas contribuições e desenvolver seu currículo de código aberto usando o OpenSauced. + +## Isues abertos, mais do que PRs que corrigem erros de digitação + + +Enquanto corrigir erros de digitação e melhorar a documentação são contribuições valiosas para projetos de código aberto, é essencial olhar além desses frutos de baixo nível e focar na resolução de issues abertos. Abordar issues abertos não apenas ajuda o projeto a avançar, mas também permite que você desenvolva uma compreensão mais profunda da base de código e demonstre suas habilidades de resolução de issues. + +Aqui estão algumas dicas para encontrar e resolver abrir issues: + + +1. **Navegue no rastreador de issues**: A maioria dos projetos de código aberto usa um rastreador de issues para gerenciar bugs, solicitações de recursos e outras tarefas. Navegue no rastreador de issues para encontrar issues que se alinhem com seus interesses e habilidades. + +2. **Procure por issues amigáveis para iniciantes**: Muitos projetos usam rótulos como "bom primeiro issue" ou "ajuda desejada" para indicar issues que são adequados para iniciantes. Comece com esses issues para construir sua confiança e ganhar experiência antes de abordar tarefas mais complexas. + +3. **Entenda a issue**: Antes de mergulhar em uma issue, certifique-se de entender o problema e o resultado desejado. Se você não tiver certeza de algo, faça perguntas ou peça esclarecimentos aos mantenedores do projeto ou a outros colaboradores. + +4. **Comunique suas intenções**: Antes de começar a trabalhar em uma issue, informe aos mantenedores do projeto e a outros colaboradores que você está interessado em abordá-la. Isso pode ajudar a evitar esforços duplicados e garantir que todos estejam na mesma página. + +5. **Teste suas alterações**: Depois de abordar uma issue, teste suas alterações minuciosamente para garantir que funcionem conforme o esperado e não introduzam novos problemas. + +Ao se concentrar em issues abertas em vez de apenas corrigir erros de digitação, você terá um impacto maior nos projetos aos quais contribui e demonstrará seu compromisso com a comunidade de código aberto. + +## Ganhar tração em suas contribuições + +Enquanto você ganha mais experiência em contribuições de código aberto, pode querer aumentar seu impacto nos projetos em que trabalha e ganhar reconhecimento por seus esforços. Aqui estão algumas estratégias para ganhar tração em suas contribuições: + +1. **Torne-se um colaborador regular**: Contribua consistentemente para os mesmos projetos ao longo do tempo. Isso ajudará você a desenvolver uma compreensão mais profunda da base de código, construir relacionamentos com outros colaboradores e se estabelecer como um membro valioso da comunidade. + +2. **Assuma tarefas desafiadoras**: À medida que você ganha experiência, aborde issues e recursos mais complexos. Isso não apenas ajudará você a crescer como desenvolvedor, mas também demonstrará sua capacidade de lidar com tarefas desafiadoras e contribuir significativamente para o projeto. + +3. **Colabore com os outros**: O código aberto é tudo sobre colaboração. Trabalhe com outros colaboradores para resolver issues, desenvolver recursos e compartilhar conhecimento. Ao colaborar efetivamente, você não apenas melhorará o projeto, mas também construirá uma forte rede de conexões na comunidade de código aberto. + +4. **Compartilhe seu conhecimento**: Compartilhe seu conhecimento e insights escrevendo postagens de blog, criando tutoriais ou dando apresentações sobre os projetos em que trabalha. Isso não apenas ajudará os outros a aprender com suas experiências, mas também o estabelecerá como um líder de pensamento na comunidade de código aberto. + + +5. **Mentore novos colaboradores**: À medida que você ganha mais experiência em contribuições de código aberto, considere orientar novos colaboradores que estão começando sua jornada de código aberto. Isso pode ajudá-lo a retribuir à comunidade, desenvolver suas habilidades de liderança e construir uma reputação positiva. + +## Desenvolva seu currículo de código aberto + +Construir um currículo de código aberto forte pode ajudá-lo a demonstrar suas habilidades, experiência e contribuições para potenciais empregadores, colaboradores e a comunidade de desenvolvedores em geral. O OpenSauced é uma excelente ferramenta para rastrear suas contribuições de código aberto e desenvolver seu currículo de código aberto. Vamos ver como você pode usar o OpenSauced para apoiar sua jornada de código aberto. + +1. **Inscreva-se em uma conta OpenSauced**: se você ainda não criou uma conta, visite [opensauced.pizza](https://opensauced.pizza/) e inscreva-se em uma conta usando suas credenciais do GitHub. + +2. **Visite sua página de perfil público**: Depois de se inscrever, uma página de perfil público será criada para você. Esta página exibirá suas informações de perfil do GitHub e uma lista de suas contribuições de código aberto. Você pode navegar até ela clicando em seu nome de usuário no canto superior direito da página. + +3. **Construa seu currículo de código aberto**: A partir daqui, você poderá adicionar destaques a Pull Requests e Issues que você contribuiu. Você também pode adicionar uma descrição e links ao seu currículo de código aberto. Eles serão agregados em uma única página que você pode compartilhar com outras pessoas, bem como um resumo de suas contribuições que será exibido em sua página de perfil público. + +Vamos mostrar nossa contribuição para o guestbook do capítulo anterior! Em seu perfil, você verá uma seção "Destaques" com uma entrada de texto. Quando você clica nisso, você pode adicionar um título, alguns pensamentos e um link para o seu PR. Isso será exibido em sua página de perfil público. Vamos adicionar um destaque para nossa contribuição para o guestbook. + +## Destacar efetivamente suas contribuições + +Informações importantes a serem incluídas ao destacar suas contribuições: + +- Novo material que você criou; +- Detalhes do projeto (ferramentas, bibliotecas, tamanho e complexidade); +- O tipo de suas contribuições: correção de bugs, recurso, desempenho, documentação, etc.; +- Os detalhes de sua contribuição, incluindo melhorias e impactos feitos no projeto e na comunidade; +- Detalhes de colaboração e trabalho em equipe; + +### Formatar seu destaque + +Para ser mais eficaz ao destacar suas contribuições, recomendamos o uso do seguinte formato: + +- **Título**: Este deve ser uma breve descrição da contribuição. Por exemplo, "Criei uma ação do GitHub para mesclar automaticamente pull requests". +- **Link** +- **Descrição**: quando você destaca sua contribuição, recomendamos mencionar o impacto que ela teve no projeto geral. Isso seria útil para destacar suas qualificações para cargos de emprego, especialmente se você tiver lacunas de emprego. Considere usar o seguinte modelo para ajudá-lo a transformar esse destaque em uma história: + - Verbo de sucesso + substantivo + métrica + resultado. + - Exemplo: Enquanto eu estava revisando alguns pull requests para o GirlScript Summer of Code deste ano, notei que a maioria deles não seria mesclada, apesar de eu e o proprietário darmos aprovações. Então, **criei uma ação do GitHub onde os pull requests são mesclados automaticamente assim que passam pelas etapas de implantação (verbo + substantivo sucessivo)**, o que **aumentou as taxas de produtividade em 80% (métrica + resultado).** + +![Adicionando um destaque ao seu perfil](../../opensauced-highlights.png) + +**Compartilhe!**: Depois de construir um portfólio de contribuições de código aberto, você pode compartilhar seu currículo de código aberto com outras pessoas clicando no botão de compartilhamento no cabeçalho de sua página de perfil. Isso pode ser especialmente útil ao se candidatar a empregos, fazer networking com outros desenvolvedores ou promover seu trabalho na comunidade de código aberto. + +Ao alavancar o OpenSauced para rastrear suas contribuições de código aberto e desenvolver seu currículo, você estará mais bem equipado para mostrar suas habilidades, experiência e impacto na comunidade de código aberto. + +Para concluir, começar a contribuir para o código aberto e causar um impacto duradouro nos projetos em que você trabalha requer uma combinação de habilidades técnicas, colaboração e persistência. Ao se concentrar em issues abertas, ganhar tração em suas contribuições e alavancar ferramentas como OpenSauced, você estará bem encaminhado para uma jornada de código aberto bem-sucedida e gratificante. + +[Último Capítulo ->](/translations/pt-br/07-conclusão.md) diff --git "a/translations/fr/pt-br/07-conclus\303\243o.md" "b/translations/fr/pt-br/07-conclus\303\243o.md" new file mode 100644 index 00000000..cf73fb4a --- /dev/null +++ "b/translations/fr/pt-br/07-conclus\303\243o.md" @@ -0,0 +1,39 @@ +# Conclusão + +Como concluímos este curso sobre como começar com open source, vamos recapitular as principais conclusões e discutir o que vem a seguir em sua jornada de open source. + +## Considerações gerais + +Ao longo deste curso, cobrimos uma variedade de tópicos projetados para ajudá-lo a entender e navegar pelo mundo do open source: + +1. **O que é open source?**: Discutimos a definição de open source, sua história e os princípios básicos que orientam o movimento open source. + +2. **Por que open source?**: Exploramos os benefícios de se envolver com projetos de open source, incluindo acesso ao conhecimento, comunidade e desenvolvimento de habilidades. + +3. **Ferramentas para ter sucesso**: Apresentamos ferramentas e plataformas essenciais para colaboradores de open source, como GitHub, Git, CodeSee, Visual Studio Code e Discord. + +4. **Como contribuir para open source**: Discutimos o processo de encontrar projetos para trabalhar, enviar contribuições, embarcar em novos projetos e o que acontece depois que sua contribuição é enviada. + +5. **O segredo do sauce**: Compartilhamos estratégias para começar com contribuições de open source, ganhar tração em suas contribuições e desenvolver seu currículo de open source usando o OpenSauced. + +Ao entender esses conceitos e aplicar as estratégias que discutimos, você estará bem equipado para embarcar em uma jornada de open source bem-sucedida. + +# O que vem a seguir? + +Com o conhecimento e as ferramentas que você adquiriu neste curso, você está pronto para mergulhar no mundo do open source e começar a fazer contribuições significativas. Aqui estão alguns próximos passos para ajudá-lo a continuar sua jornada de open source: + +1. **Identifique seus interesses e objetivos**: Antes de começar a contribuir para projetos de open source, reserve um tempo para pensar em seus interesses, paixões e objetivos. Isso ajudará você a identificar projetos que se alinham com seus valores e objetivos. + +2. **Encontre projetos para contribuir**: Use plataformas como GitHub, OpenSauced e CodeTriage para descobrir projetos de open source que se alinham com seus interesses e habilidades. Procure projetos com comunidades ativas, documentação clara e diretrizes de contribuição bem definidas. + +3. **Comece a contribuir**: Depois de identificar um projeto para contribuir, comece abordando tarefas pequenas e gerenciáveis para construir sua confiança e ganhar experiência. À medida que você se sentir mais confortável, assuma tarefas e desafios mais complexos. + +4. **Conecte-se com a comunidade de open source**: Junte-se a fóruns on-line, plataformas de bate-papo e grupos de mídia social relacionados aos projetos que você está interessado. Interaja com outros colaboradores, faça perguntas e compartilhe seu conhecimento. + +5. **Participe de eventos e conferências**: Participe de eventos, conferências e encontros de open source para aprender com os outros, fazer networking com outros desenvolvedores e se manter atualizado sobre as últimas tendências e melhores práticas no mundo do open source. + +6. **Compartilhe suas experiências**: Documente sua jornada de open source escrevendo postagens de blog, criando tutoriais ou dando apresentações. Isso não apenas ajudará os outros a aprender com suas experiências, mas também o estabelecerá como um líder de pensamento na comunidade de open source. + +7. **Continue aprendendo**: O open source é um campo dinâmico e em constante evolução. Mantenha-se atualizado com as últimas ferramentas, técnicas e melhores práticas participando de workshops, fazendo cursos on-line e lendo artigos e livros sobre desenvolvimento de open source. Incluímos uma [seção de recursos adicionais](/translations/pt-br/08-recursos-adicionais.md) para obter mais informações. + +Em conclusão, embarcar em uma jornada de open source é uma experiência gratificante e enriquecedora que pode ajudá-lo a desenvolver novas habilidades, se conectar com pessoas de mentalidade semelhante e ter um impacto duradouro nos projetos em que trabalha. Com o conhecimento e as ferramentas que você adquiriu neste curso, você está bem preparado para enfrentar os desafios e oportunidades emocionantes que o aguardam no mundo do open source. Então vá em frente e comece a contribuir - a comunidade de open source aguarda ansiosamente sua participação! \ No newline at end of file diff --git a/translations/fr/pt-br/08-recursos-adicionais.md b/translations/fr/pt-br/08-recursos-adicionais.md new file mode 100644 index 00000000..5ff6e1c0 --- /dev/null +++ b/translations/fr/pt-br/08-recursos-adicionais.md @@ -0,0 +1,25 @@ +Felicitações por sua jornada no open source! Aqui estão alguns recursos para aprender mais sobre como começar no open source:source: + +## Guias e Tutoriais + +- [Open Source Guides](https://opensource.guide/) por GitHub: Guias abrangentes sobre vários aspectos do open source, incluindo como começar, contribuir, manter projetos e construir comunidades. + +- [Primeira Contribuição](https://github.com/firstcontributions/first-contributions) por Roshan Jossey: Um guia para iniciantes que o guia por sua primeira contribuição para um projeto de código aberto. + +- [Guia para iniciantes em Desenvolvimento de Software Open Source](https://training.linuxfoundation.org/training/beginners-guide-open-source-software-development/) por The Linux Foundation: Um curso online gratuito que aborda os conceitos básicos do open source, incluindo sua história, licenças e modelos de desenvolvimento. + +- [Mozilla's Open Source Student Network (OSSN)](https://community.mozilla.org/en/): Fornece recursos e suporte para estudantes interessados em open source, incluindo guias, eventos e oportunidades de mentoria. + +- [Introdução ao GitHub e projetos Open Source](https://www.digitalocean.com/community/tutorial_series/an-introduction-to-open-source) por DigitalOcean: Uma série de tutoriais para iniciantes que aborda os conceitos básicos do open source, incluindo como encontrar projetos para contribuir, entender o código e enviar contribuições. + +- [Open Source Friday](https://opensourcefriday.com/) por GitHub: Um movimento global que incentiva indivíduos e organizações a contribuir para o open source todas as sextas-feiras. O site fornece recursos e guias sobre como começar no open source e encontrar projetos para contribuir. + +## Blog posts + +- [Além da Criação de Conteúdo: Como as Contribuições de Open Source Podem Ajudá-lo a Ser Notado](https://dev.to/opensauced/beyond-content-creation-how-open-source-contributions-can-help-you-get-noticed-4l5n) + +- [Escrevendo sua primeira Pull Request: Dicas, Melhores Práticas e Ferramentas com Inteligência Artificial para o Sucesso](https://dev.to/opensauced/writing-your-first-pull-request-tips-best-practices-and-ai-powered-tools-for-success-3bg9) + +- [Como Contribuir para Open Source sem Saber Programar: Um guia com sugestões de projetos](https://dev.to/opensauced/how-to-contribute-to-open-source-without-knowing-how-to-code-a-guide-with-project-suggestions-59e5) + +- [Como Escrever uma Boa Issue: Dicas para Comunicação Eficaz em Open Source](https://dev.to/opensauced/how-to-write-a-good-issue-tips-for-effective-communication-in-open-source-5443) \ No newline at end of file diff --git "a/translations/fr/pt-br/09-gloss\303\241rio.md" "b/translations/fr/pt-br/09-gloss\303\241rio.md" new file mode 100644 index 00000000..9b14d18c --- /dev/null +++ "b/translations/fr/pt-br/09-gloss\303\241rio.md" @@ -0,0 +1,88 @@ +## Repositório + +Um repositório é um local central onde o código é armazenado e gerenciado. Em open source, os repositórios geralmente são hospedados em plataformas como GitHub, GitLab ou Bitbucket. Cada repositório pode conter um ou mais projetos, e os contribuidores podem enviar alterações no código fazendo solicitações pull. + +## Mantenedor + +Um mantenedor é uma pessoa ou um grupo de pessoas responsável por manter um projeto de open source específico. Os mantenedores são normalmente responsáveis ​​por revisar e aceitar ou rejeitar as contribuições de outros contribuidores. Eles também têm autoridade para tomar as decisões finais sobre a direção e o escopo do projeto. + +## Membro Principal + +Um membro principal é um colaborador que recebeu privilégios ou responsabilidades adicionais em um projeto de open source. Os membros principais geralmente são colaboradores confiáveis ​​que demonstraram um profundo conhecimento do projeto e fizeram contribuições significativas para o seu desenvolvimento. + +## Emitir + +Um problema é um problema ou bug que precisa ser resolvido no código. Os problemas podem ser criados por qualquer pessoa e geralmente são usados ​​para rastrear bugs, solicitações de recursos e outras tarefas que precisam ser executadas. + +# Contribuidor + +Um colaborador é qualquer pessoa que faz alterações, acréscimos ou sugestões a um projeto de open source. Os colaboradores podem ser desenvolvedores, designers, escritores, testadores ou qualquer outra pessoa que ajude a tornar o projeto melhor. + +## Clonar + +A clonagem é o processo usado para copiar um repositório Git existente para um novo diretório local. O comando `git clone` criará um novo diretório local para o repositório, copiará todo o conteúdo do repositório especificado, criará os branches rastreados remotos e fará o checkout de um branch inicial localmente. Por padrão, o clone do Git criará uma referência ao repositório remoto chamado origin. + +## Garfo + +Uma bifurcação é uma cópia de um repositório. Ao bifurcar um repositório, você cria uma nova cópia da base de código que pode modificar e experimentar sem afetar a base de código original. + +## Filial + +Uma ramificação é uma versão separada do código criada para fins de desenvolvimento. As ramificações permitem que os contribuidores experimentem as alterações sem afetar a base de código principal. Quando as alterações estão prontas para serem mescladas na base de código principal, elas geralmente são enviadas como uma pull request. + +## Solicitação de pull + +Uma solicitação pull é uma solicitação de um contribuidor a um mantenedor para que as alterações feitas no código sejam inseridas em uma base de código. + +## Mesclar + +Mesclar é o processo de combinar alterações de uma ramificação em outra. Quando uma solicitação pull é aceita e mesclada, as alterações feitas na solicitação pull tornam-se parte da base de código principal. + +## Documentos + +Esta é uma abreviação da palavra documentação, um pedaço de texto que fornece informações sobre como contribuir para projetos OSS e expectativas para contribuidores. Markdown, uma linguagem de codificação baseada em texto, é frequentemente usada para criar essas formas de conteúdo. Quer ver um em ação? Confira o [Guia de estilo em nosso repositório Pizza Verse](https://github.com/open-sauced/pizza-verse/blob/main/style-guide.md)! +Esta é uma abr## Repositório + +Um repositório é um local central onde o código é armazenado e gerenciado. Em open source, os repositórios geralmente são hospedados em plataformas como GitHub, GitLab ou Bitbucket. Cada repositório pode conter um ou mais projetos, e os contribuidores podem enviar alterações no código fazendo solicitações pull. + +## Mantenedor + +Um mantenedor é uma pessoa ou um grupo de pessoas responsável por manter um projeto de open source específico. Os mantenedores são normalmente responsáveis ​​por revisar e aceitar ou rejeitar as contribuições de outros contribuidores. Eles também têm autoridade para tomar as decisões finais sobre a direção e o escopo do projeto. + +## Membro Principal + +Um membro principal é um colaborador que recebeu privilégios ou responsabilidades adicionais em um projeto de open source. Os membros principais geralmente são colaboradores confiáveis ​​que demonstraram um profundo conhecimento do projeto e fizeram contribuições significativas para o seu desenvolvimento. + +## Emitir + +Um problema é um problema ou bug que precisa ser resolvido no código. Os problemas podem ser criados por qualquer pessoa e geralmente são usados ​​para rastrear bugs, solicitações de recursos e outras tarefas que precisam ser executadas. + +# Contribuidor + +Um colaborador é qualquer pessoa que faz alterações, acréscimos ou sugestões a um projeto de open source. Os colaboradores podem ser desenvolvedores, designers, escritores, testadores ou qualquer outra pessoa que ajude a tornar o projeto melhor. + +## Clonar + +A clonagem é o processo usado para copiar um repositório Git existente para um novo diretório local. O comando `git clone` criará um novo diretório local para o repositório, copiará todo o conteúdo do repositório especificado, criará os branches rastreados remotos e fará o checkout de um branch inicial localmente. Por padrão, o clone do Git criará uma referência ao repositório remoto chamado origin. + +## Garfo + +Uma bifurcação é uma cópia de um repositório. Ao bifurcar um repositório, você cria uma nova cópia da base de código que pode modificar e experimentar sem afetar a base de código original. + +## Filial + +Uma ramificação é uma versão separada do código criada para fins de desenvolvimento. As ramificações permitem que os contribuidores experimentem as alterações sem afetar a base de código principal. Quando as alterações estão prontas para serem mescladas na base de código principal, elas geralmente são enviadas como uma pull request. + +## Solicitação de pull + +Uma solicitação pull é uma solicitação de um contribuidor a um mantenedor para que as alterações feitas no código sejam inseridas em uma base de código. + +## Mesclar + +Mesclar é o processo de combinar alterações de uma ramificação em outra. Quando uma solicitação pull é aceita e mesclada, as alterações feitas na solicitação pull tornam-se parte da base de código principal. + +## Documentos + +Isso é uma abreviação da palavra "documentação", um pedaço de texto que fornece informações sobre como contribuir para projetos de código aberto e expectativas para os contribuidores. +O Markdown, uma linguagem de codificação baseada em texto, é frequentemente usado para criar esse tipo de conteúdo. +Quer ver um exemplo em ação? Confira o [Guia de Estilo no nosso repositório Pizza Verse](https://github.com/open-sauced/pizza-verse/blob/main/style-guide.md)! diff --git a/translations/fr/pt-br/README.pt.md b/translations/fr/pt-br/README.pt.md new file mode 100644 index 00000000..33c937bb --- /dev/null +++ b/translations/fr/pt-br/README.pt.md @@ -0,0 +1,57 @@ +
+
+ Open Sauced +

🍕 Introdução ao Open Source com OpenSauced 🍕

+ O site fornece materiais do curso Introdução ao Open Source com OpenSauced. +
+
+ +Bem-vindo ao curso de Introdução ao Open Source com OpenSauced! Este curso foi projetado para fornecer uma introdução ao open source e orientá-lo no processo de contribuição para projetos de open source. + +## Suporte de idioma + +- [English](../../README.md) + +## Visão geral do curso + +O curso é dividido em cinco capítulos, cada um cobrindo um aspecto diferente do open source: + +1. **O que é open source?** Este capítulo fornece uma introdução ao open source, sua história e sua importância no cenário atual de desenvolvimento de software. + +2. **Por que open source?** Neste capítulo, você aprenderá sobre os benefícios do software open source, como colaboração aumentada, desenvolvimento mais rápido e qualidade aprimorada. + +3. **Ferramentas para ter sucesso.** Descubra as principais ferramentas e plataformas necessárias para uma jornada de sucesso no desenvolvimento de open source. Do Git e GitHub para controle de versão e colaboração ao CodeSee para visualização de código e VS Code como seu editor de código, este capítulo fornece uma visão geral de como aproveitar essas ferramentas essenciais. + +4. **Como contribuir para o open source.** +Este capítulo abrange a busca de projetos para trabalhar, o envio de contribuições, a integração em novos projetos e os resultados após o envio de contribuições. As dicas para encontrar projetos incluem navegar no GitHub e GitLab, seguir interesses pessoais, participar de comunidades de open source e utilizar plataformas como OpenSauced. + +5. **O segredo do sauce.** +Este capítulo se concentra em fornecer estratégias e dicas menos conhecidas para causar um impacto duradouro na comunidade de open source. Este capítulo fornece estratégias para encontrar problemas, ganhar tração em sua jornada de open source e alavancar o OpenSauced para construir seu currículo de open source. + +## Informações adicionais + +Este é o início da sua jornada de open source, por isso fornecemos alguns recursos adicionais para ajudá-lo a começar: +- [Glossário](/translations/pt-br/09-glossário.md): Um glossário de termos e definições comuns usados no open source. +- [Recursos adicionais](/translations/pt-br/08-recursos-adicionais.md): Uma lista de recursos adicionais para aprender mais sobre open source, incluindo postagens de blog, tutoriais e guias. + +## Começando + +Para começar o curso, basta navegar até o arquivo [`intro`](/translations/pt-br/01-introdução.md) no repositório e começar a ler! Cada capítulo se baseia no anterior, portanto, recomendamos lê-los em ordem. + +Conforme você trabalha no curso, incentivamos você a experimentar as ferramentas e conceitos abordados em cada capítulo. A melhor maneira de aprender é fazendo, portanto, tente contribuir para um projeto de open source real ou criar seu próprio projeto do zero! + +## Construindo seu currículo open source + +Um dos recursos exclusivos deste curso é que ele fornece orientações sobre como construir seu currículo de open source usando o OpenSauced. O OpenSauced é uma plataforma que ajuda você a rastrear e mostrar suas contribuições de open source, facilitando a notificação por potenciais empregadores e colaboradores. + +Para saber mais sobre como usar o OpenSauced para construir seu currículo de open source, não deixe de conferir a seção `Construindo seu currículo de open source` no [Capítulo 6 - O segredo do sauce](/translations/pt-br/06-o-segredo-do%20sauce.md). + +
+ +Nós da Open Sauced estamos muito animados para compartilhar este curso com você! Esperamos que você ache este curso informativo e útil! Se você tiver alguma dúvida ou comentário, não hesite em abrir uma issue ou entrar em contato conosco na comunidade OpenSauced Discord. + +Feliz aprendizado e contribuição! + +🤝 Contribuindo para este Repositório Nós encorajamos você a contribuir para o OpenSauced! Todos os colaboradores são obrigados a cumprir o nosso [Código de Conduta](https://github.com/open-sauced/.github/blob/main/CODE_OF_CONDUCT.md). Confira o [Guia de contribuição](https://docs.opensauced.pizza/contributing/introduction-to-contributing/) para obter orientações sobre como proceder com sua contribuição. + +[![Licença Creative Commons](https://i.creativecommons.org/l/by/4.0/88x31.png)](https://creativecommons.org/licenses/by/4.0/deed.pt_BR) diff --git a/translations/fr/pt-br/_layouts/sidebar.md b/translations/fr/pt-br/_layouts/sidebar.md new file mode 100644 index 00000000..33833659 --- /dev/null +++ b/translations/fr/pt-br/_layouts/sidebar.md @@ -0,0 +1,10 @@ +- Páginas + - [Introdução](/translations/pt-br/01-introdução.md) + - [O que é Open Source?](/translations/pt-br/02-o-que-é-open-source.md) + - [Por que Open Source?](/translations/pt-br/03-por-que-open-source.md) + - [Ferramentas utilizadas](/translations/pt-br/04-ferramentas-utilizadas.md) + - [Como Contribuir Para Open Source](/translations/pt-br/05-como-contribuir-para-open-source.md) + - [O segredo do sauce](/translations/pt-br/06-o-molho-secreto.md) + - [Conclusão](/translations/pt-br/07-conclusão.md) + - [Recursos Adicionais](/translations/pt-br/08-recursos-adicionais.md) + - [Glossário](/translations/pt-br/09-glossário.md) \ No newline at end of file From 7bff80fd8975aa1f79ff638a21197e0f42ae37bb Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Thu, 21 Sep 2023 20:38:21 -0400 Subject: [PATCH 08/62] fix: move portuguese into translation folder --- _layouts/navbar.md | 1 + .../pt-br/01-introdu\303\247\303\243o.md" | 0 .../pt-br/02-o-que-\303\251-open-source.md" | 0 translations/{fr => }/pt-br/03-por-que-open-source.md | 0 translations/{fr => }/pt-br/04-ferramentas-utilizadas.md | 0 .../{fr => }/pt-br/05-como-contribuir-para-open-source.md | 0 translations/{fr => }/pt-br/06-o-segredo-do sauce.md | 0 .../pt-br/07-conclus\303\243o.md" | 0 translations/{fr => }/pt-br/08-recursos-adicionais.md | 0 .../pt-br/09-gloss\303\241rio.md" | 0 translations/{fr => }/pt-br/README.pt.md | 0 translations/{fr => }/pt-br/_layouts/navbar.md | 3 ++- translations/{fr => }/pt-br/_layouts/sidebar.md | 0 13 files changed, 3 insertions(+), 1 deletion(-) rename "translations/fr/pt-br/01-introdu\303\247\303\243o.md" => "translations/pt-br/01-introdu\303\247\303\243o.md" (100%) rename "translations/fr/pt-br/02-o-que-\303\251-open-source.md" => "translations/pt-br/02-o-que-\303\251-open-source.md" (100%) rename translations/{fr => }/pt-br/03-por-que-open-source.md (100%) rename translations/{fr => }/pt-br/04-ferramentas-utilizadas.md (100%) rename translations/{fr => }/pt-br/05-como-contribuir-para-open-source.md (100%) rename translations/{fr => }/pt-br/06-o-segredo-do sauce.md (100%) rename "translations/fr/pt-br/07-conclus\303\243o.md" => "translations/pt-br/07-conclus\303\243o.md" (100%) rename translations/{fr => }/pt-br/08-recursos-adicionais.md (100%) rename "translations/fr/pt-br/09-gloss\303\241rio.md" => "translations/pt-br/09-gloss\303\241rio.md" (100%) rename translations/{fr => }/pt-br/README.pt.md (100%) rename translations/{fr => }/pt-br/_layouts/navbar.md (75%) rename translations/{fr => }/pt-br/_layouts/sidebar.md (100%) diff --git a/_layouts/navbar.md b/_layouts/navbar.md index a4835bfd..6d5a71ab 100644 --- a/_layouts/navbar.md +++ b/_layouts/navbar.md @@ -3,3 +3,4 @@ * Languages * [:us: English ](/) * [:fr: French ](/translations/fr/) + * [:br🇧🇷: Portuguese](/translations/p) diff --git "a/translations/fr/pt-br/01-introdu\303\247\303\243o.md" "b/translations/pt-br/01-introdu\303\247\303\243o.md" similarity index 100% rename from "translations/fr/pt-br/01-introdu\303\247\303\243o.md" rename to "translations/pt-br/01-introdu\303\247\303\243o.md" diff --git "a/translations/fr/pt-br/02-o-que-\303\251-open-source.md" "b/translations/pt-br/02-o-que-\303\251-open-source.md" similarity index 100% rename from "translations/fr/pt-br/02-o-que-\303\251-open-source.md" rename to "translations/pt-br/02-o-que-\303\251-open-source.md" diff --git a/translations/fr/pt-br/03-por-que-open-source.md b/translations/pt-br/03-por-que-open-source.md similarity index 100% rename from translations/fr/pt-br/03-por-que-open-source.md rename to translations/pt-br/03-por-que-open-source.md diff --git a/translations/fr/pt-br/04-ferramentas-utilizadas.md b/translations/pt-br/04-ferramentas-utilizadas.md similarity index 100% rename from translations/fr/pt-br/04-ferramentas-utilizadas.md rename to translations/pt-br/04-ferramentas-utilizadas.md diff --git a/translations/fr/pt-br/05-como-contribuir-para-open-source.md b/translations/pt-br/05-como-contribuir-para-open-source.md similarity index 100% rename from translations/fr/pt-br/05-como-contribuir-para-open-source.md rename to translations/pt-br/05-como-contribuir-para-open-source.md diff --git a/translations/fr/pt-br/06-o-segredo-do sauce.md b/translations/pt-br/06-o-segredo-do sauce.md similarity index 100% rename from translations/fr/pt-br/06-o-segredo-do sauce.md rename to translations/pt-br/06-o-segredo-do sauce.md diff --git "a/translations/fr/pt-br/07-conclus\303\243o.md" "b/translations/pt-br/07-conclus\303\243o.md" similarity index 100% rename from "translations/fr/pt-br/07-conclus\303\243o.md" rename to "translations/pt-br/07-conclus\303\243o.md" diff --git a/translations/fr/pt-br/08-recursos-adicionais.md b/translations/pt-br/08-recursos-adicionais.md similarity index 100% rename from translations/fr/pt-br/08-recursos-adicionais.md rename to translations/pt-br/08-recursos-adicionais.md diff --git "a/translations/fr/pt-br/09-gloss\303\241rio.md" "b/translations/pt-br/09-gloss\303\241rio.md" similarity index 100% rename from "translations/fr/pt-br/09-gloss\303\241rio.md" rename to "translations/pt-br/09-gloss\303\241rio.md" diff --git a/translations/fr/pt-br/README.pt.md b/translations/pt-br/README.pt.md similarity index 100% rename from translations/fr/pt-br/README.pt.md rename to translations/pt-br/README.pt.md diff --git a/translations/fr/pt-br/_layouts/navbar.md b/translations/pt-br/_layouts/navbar.md similarity index 75% rename from translations/fr/pt-br/_layouts/navbar.md rename to translations/pt-br/_layouts/navbar.md index e406a670..d0885d7c 100644 --- a/translations/fr/pt-br/_layouts/navbar.md +++ b/translations/pt-br/_layouts/navbar.md @@ -2,4 +2,5 @@ * [⭐ Star The Repo](https://github.com/open-sauced/intro) * Languages * [:us: English](/) - * [:br🇧🇷: Português](/translations/pt-br/README.pt.md) \ No newline at end of file + * [:br🇧🇷: Português](/translations/pt-br/README.pt.md) + * [:fr🇫🇷: French](/translations/fr/README.md) \ No newline at end of file diff --git a/translations/fr/pt-br/_layouts/sidebar.md b/translations/pt-br/_layouts/sidebar.md similarity index 100% rename from translations/fr/pt-br/_layouts/sidebar.md rename to translations/pt-br/_layouts/sidebar.md From 094a1c27f4a28720af85ffa0c510aea11e1c8de2 Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Thu, 21 Sep 2023 20:42:51 -0400 Subject: [PATCH 09/62] fix: add brazil to navbar --- _layouts/navbar.md | 2 +- translations/pt-br/{README.pt.md => README.md} | 0 translations/pt-br/_layouts/navbar.md | 2 +- 3 files changed, 2 insertions(+), 2 deletions(-) rename translations/pt-br/{README.pt.md => README.md} (100%) diff --git a/_layouts/navbar.md b/_layouts/navbar.md index 6d5a71ab..7ba6c953 100644 --- a/_layouts/navbar.md +++ b/_layouts/navbar.md @@ -3,4 +3,4 @@ * Languages * [:us: English ](/) * [:fr: French ](/translations/fr/) - * [:br🇧🇷: Portuguese](/translations/p) + * [:br🇧🇷:Portuguese](/translations/pt-br/) diff --git a/translations/pt-br/README.pt.md b/translations/pt-br/README.md similarity index 100% rename from translations/pt-br/README.pt.md rename to translations/pt-br/README.md diff --git a/translations/pt-br/_layouts/navbar.md b/translations/pt-br/_layouts/navbar.md index d0885d7c..53c68eb6 100644 --- a/translations/pt-br/_layouts/navbar.md +++ b/translations/pt-br/_layouts/navbar.md @@ -2,5 +2,5 @@ * [⭐ Star The Repo](https://github.com/open-sauced/intro) * Languages * [:us: English](/) - * [:br🇧🇷: Português](/translations/pt-br/README.pt.md) + * [:br🇧🇷: Português](/translations/pt-br/README.md) * [:fr🇫🇷: French](/translations/fr/README.md) \ No newline at end of file From 6784c43e98566e04db9ca700858ec2c04a85f02b Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Thu, 21 Sep 2023 21:00:56 -0400 Subject: [PATCH 10/62] fix: translate sidebar into Portuguese --- _layouts/navbar.md | 6 +++--- translations/fr/_layouts/navbar.md | 3 ++- translations/pt-br/README.md | 3 ++- translations/pt-br/_layouts/navbar.md | 10 +++++----- 4 files changed, 12 insertions(+), 10 deletions(-) diff --git a/_layouts/navbar.md b/_layouts/navbar.md index 7ba6c953..346c6490 100644 --- a/_layouts/navbar.md +++ b/_layouts/navbar.md @@ -1,6 +1,6 @@ * [Home Page](/) * [⭐ Star The Repo](https://github.com/open-sauced/intro) * Languages - * [:us: English ](/) - * [:fr: French ](/translations/fr/) - * [:br🇧🇷:Portuguese](/translations/pt-br/) + * [:us: English](/) + * [:fr🇫🇷 : French](/translations/fr/) + * [:br🇧🇷 : Portuguese](/translations/pt-br/) diff --git a/translations/fr/_layouts/navbar.md b/translations/fr/_layouts/navbar.md index df733200..2267e303 100644 --- a/translations/fr/_layouts/navbar.md +++ b/translations/fr/_layouts/navbar.md @@ -1,5 +1,6 @@ * [Accueil](/translations/fr/) * [⭐ Donner une étoile au projet](https://github.com/open-sauced/intro) -* Languages +* Langues * [:us: Anglais ](/) * [:fr: Français ](/translations/fr/) + * [:br🇧🇷: Portugais](/translations/pt-br/) diff --git a/translations/pt-br/README.md b/translations/pt-br/README.md index 33c937bb..213f0c67 100644 --- a/translations/pt-br/README.md +++ b/translations/pt-br/README.md @@ -10,7 +10,8 @@ Bem-vindo ao curso de Introdução ao Open Source com OpenSauced! Este curso foi ## Suporte de idioma -- [English](../../README.md) +- [Inglês](../../README.md) +- [Francês](../fr/README.md) ## Visão geral do curso diff --git a/translations/pt-br/_layouts/navbar.md b/translations/pt-br/_layouts/navbar.md index 53c68eb6..0e810906 100644 --- a/translations/pt-br/_layouts/navbar.md +++ b/translations/pt-br/_layouts/navbar.md @@ -1,6 +1,6 @@ -* [Home Page](/) -* [⭐ Star The Repo](https://github.com/open-sauced/intro) -* Languages - * [:us: English](/) +* [Pagina inicial](/) +* [⭐ Marque o repositório com estrela](https://github.com/open-sauced/intro) +* Idioma + * [:us: Inglês](/) * [:br🇧🇷: Português](/translations/pt-br/README.md) - * [:fr🇫🇷: French](/translations/fr/README.md) \ No newline at end of file + * [:fr🇫🇷: Francês](/translations/fr/README.md) \ No newline at end of file From f86fb42cf5b985650abc0ac3ca82cd11acb8054c Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Thu, 21 Sep 2023 21:03:01 -0400 Subject: [PATCH 11/62] feat: add and hyperlink Portuguese section --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index c42e0499..996a62a6 100644 --- a/README.md +++ b/README.md @@ -10,6 +10,7 @@ Welcome to the Intro to Open Source Course with OpenSauced! This course is desig ## Language Support Like pizza, open source is meant to be shared with everyone. Click on the links below to take this course in the following languages - [French](./translations/fr/README.md) +- [Portuguese](./translations/pt-br/README.md) ## Course Overview From 6f3700fadb2f6660620f317be9d126ef8e536173 Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Thu, 21 Sep 2023 21:20:12 -0400 Subject: [PATCH 12/62] fix: elaborated about contributing in the Readme --- translations/pt-br/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/translations/pt-br/README.md b/translations/pt-br/README.md index 213f0c67..ea3b9f01 100644 --- a/translations/pt-br/README.md +++ b/translations/pt-br/README.md @@ -53,6 +53,6 @@ Nós da Open Sauced estamos muito animados para compartilhar este curso com voc Feliz aprendizado e contribuição! -🤝 Contribuindo para este Repositório Nós encorajamos você a contribuir para o OpenSauced! Todos os colaboradores são obrigados a cumprir o nosso [Código de Conduta](https://github.com/open-sauced/.github/blob/main/CODE_OF_CONDUCT.md). Confira o [Guia de contribuição](https://docs.opensauced.pizza/contributing/introduction-to-contributing/) para obter orientações sobre como proceder com sua contribuição. +🤝 Interessado em contribuir? Contribuindo para este Repositório Nós encorajamos você a contribuir para o OpenSauced! Todos os colaboradores são obrigados a cumprir o nosso [Código de Conduta](https://github.com/open-sauced/.github/blob/main/CODE_OF_CONDUCT.md). Confira o [Guia de contribuição](https://docs.opensauced.pizza/contributing/introduction-to-contributing/) para obter orientações sobre como proceder com sua contribuição. [![Licença Creative Commons](https://i.creativecommons.org/l/by/4.0/88x31.png)](https://creativecommons.org/licenses/by/4.0/deed.pt_BR) From 9d78d68bdebbb60470ad08171864e73c5884edcb Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Thu, 21 Sep 2023 21:32:02 -0400 Subject: [PATCH 13/62] fix: fix pathways for page links --- "translations/pt-br/01-introdu\303\247\303\243o.md" | 2 +- translations/pt-br/03-por-que-open-source.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git "a/translations/pt-br/01-introdu\303\247\303\243o.md" "b/translations/pt-br/01-introdu\303\247\303\243o.md" index bf8b3a8c..66f330e0 100644 --- "a/translations/pt-br/01-introdu\303\247\303\243o.md" +++ "b/translations/pt-br/01-introdu\303\247\303\243o.md" @@ -64,4 +64,4 @@ Usar os exemplos e demos como ponto de partida, mas não tenha medo de explorar Agora que nos apresentamos, é hora de embarcar em sua jornada de open source! No próximo capítulo, mergulharemos na definição de open source e exploraremos sua história, preparando o cenário para uma compreensão mais profunda da colaboração de open source. Vamos começar! -[Próximo Capítulo ->](./02-what-is-open-source.md) \ No newline at end of file +[Próximo Capítulo ->](/translations/pt-br/02-o-que-é-open-source.md) \ No newline at end of file diff --git a/translations/pt-br/03-por-que-open-source.md b/translations/pt-br/03-por-que-open-source.md index 26a08c1f..a7aaf4ca 100644 --- a/translations/pt-br/03-por-que-open-source.md +++ b/translations/pt-br/03-por-que-open-source.md @@ -54,4 +54,4 @@ Além dos benefícios mencionados acima, contribuir para projetos de código abe No próximo capítulo, discutiremos as ferramentas e recursos essenciais de que você precisará para ter sucesso em sua jornada de código aberto, incluindo GitHub, Git, CodeSee, VS Code e Discord. Ao se familiarizar com essas ferramentas, você estará melhor equipado para colaborar com outras pessoas, gerenciar seus projetos e contribuir efetivamente para projetos de código aberto. -[Próximo Capítulo -->](./04-tools-to-be-successful.md) \ No newline at end of file +[Próximo Capítulo -->](/translations/pt-br/04-ferramentas-utilizadas.md) \ No newline at end of file From e1689f8e3f25f4d06351000db3c41a1d3e1231d0 Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Thu, 21 Sep 2023 21:33:33 -0400 Subject: [PATCH 14/62] fix: revise pathway for course link --- translations/pt-br/05-como-contribuir-para-open-source.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/translations/pt-br/05-como-contribuir-para-open-source.md b/translations/pt-br/05-como-contribuir-para-open-source.md index d23c5ef8..ccd33018 100644 --- a/translations/pt-br/05-como-contribuir-para-open-source.md +++ b/translations/pt-br/05-como-contribuir-para-open-source.md @@ -25,4 +25,4 @@ No [Discord do OpenSauced](https://discord.com/invite/U2peSNf23P), por exemplo, 4. **Aproveite o OpenSauced**: [OpenSauced](https://opensauced.pizza/) é uma plataforma que ajuda os desenvolvedores a descobrir e contribuir com projetos de open source. Ao usar o OpenSauced, você pode encontrar projetos alinhados com seus interesses, habilidades e objetivos. -[Próximo Capítulo ->](/translations/pt-br/06-o-molho-secreto.md) \ No newline at end of file +[Próximo Capítulo ->](/translations/pt-br/06-o-segredo-do%20sauce.md) \ No newline at end of file From 1bb8a5f119f6d499c80214d183ec3f766fdf2a7a Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Sat, 30 Sep 2023 16:45:27 -0400 Subject: [PATCH 15/62] fix: turn links into flags --- README.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 030bda43..5e8d7675 100644 --- a/README.md +++ b/README.md @@ -8,10 +8,11 @@ Welcome to the Intro to Open Source Course with OpenSauced! This course is designed to provide you with an introduction to open source and guide you through the process of contributing to open source projects. ## Language Support -Like pizza, open source is meant to be shared with everyone. Click on the links below to take this course in the following languages: -- [French](./translations/fr/README.md) -- [Portuguese](./translations/pt-br/README.md) +Like pizza, open source is meant to be shared with everyone. Click on the flags below to take this course in the following languages: +[French](translations/fr/README.md) +[English](translations/fr/README.md) +[Portuguese Brazilian](translations/fr/README.md) ## Course Overview The course is divided into five chapters, each covering a different aspect of open source: From cb6d45a795b824da7d7e1c150fbf97183aa8aa4b Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Sat, 30 Sep 2023 16:50:59 -0400 Subject: [PATCH 16/62] feat: revise flag order in sidebar --- translations/pt-br/_layouts/navbar.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/translations/pt-br/_layouts/navbar.md b/translations/pt-br/_layouts/navbar.md index 0e810906..1d49148a 100644 --- a/translations/pt-br/_layouts/navbar.md +++ b/translations/pt-br/_layouts/navbar.md @@ -1,6 +1,6 @@ * [Pagina inicial](/) * [⭐ Marque o repositório com estrela](https://github.com/open-sauced/intro) * Idioma - * [:us: Inglês](/) + * [:fr🇫🇷: Francês](/translations/fr/README.md) * [:br🇧🇷: Português](/translations/pt-br/README.md) - * [:fr🇫🇷: Francês](/translations/fr/README.md) \ No newline at end of file + * [:us: Inglês](/) \ No newline at end of file From 044f04548d644f945c93ca892be41bbbb374e90b Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Sat, 30 Sep 2023 17:15:42 -0400 Subject: [PATCH 17/62] fix: revise hyperlink --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 5e8d7675..fa27a6e6 100644 --- a/README.md +++ b/README.md @@ -12,7 +12,7 @@ Like pizza, open source is meant to be shared with everyone. Click on the flags [French](translations/fr/README.md) [English](translations/fr/README.md) -[Portuguese Brazilian](translations/fr/README.md) +[Portuguese Brazilian](translations/pt-br/README.md) ## Course Overview The course is divided into five chapters, each covering a different aspect of open source: From d8e3105ef2b63aece10c85fead55b08ec18512fb Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Sun, 15 Oct 2023 14:24:29 -0400 Subject: [PATCH 18/62] feat: added country flags to brazilian readme --- translations/pt-br/README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/translations/pt-br/README.md b/translations/pt-br/README.md index ea3b9f01..7a427fa4 100644 --- a/translations/pt-br/README.md +++ b/translations/pt-br/README.md @@ -9,9 +9,9 @@ Bem-vindo ao curso de Introdução ao Open Source com OpenSauced! Este curso foi projetado para fornecer uma introdução ao open source e orientá-lo no processo de contribuição para projetos de open source. ## Suporte de idioma - -- [Inglês](../../README.md) -- [Francês](../fr/README.md) +Assim como a pizza, open source deve ser compartilhado com todos. Clique nos links abaixo para seguir este curso nos seguintes idiomas diferentes. +[Francês](translations/fr/README.md) +[Inglês](translations/fr/README.md) ## Visão geral do curso From cb9cca787c88c436834946f99c3b628ce560f736 Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Sun, 15 Oct 2023 14:25:26 -0400 Subject: [PATCH 19/62] fix: omit period and used colon --- translations/pt-br/README.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/translations/pt-br/README.md b/translations/pt-br/README.md index 7a427fa4..854d4d9d 100644 --- a/translations/pt-br/README.md +++ b/translations/pt-br/README.md @@ -9,7 +9,8 @@ Bem-vindo ao curso de Introdução ao Open Source com OpenSauced! Este curso foi projetado para fornecer uma introdução ao open source e orientá-lo no processo de contribuição para projetos de open source. ## Suporte de idioma -Assim como a pizza, open source deve ser compartilhado com todos. Clique nos links abaixo para seguir este curso nos seguintes idiomas diferentes. +Assim como a pizza, open source deve ser compartilhado com todos. Clique nos links abaixo para seguir este curso nos seguintes idiomas diferentes: + [Francês](translations/fr/README.md) [Inglês](translations/fr/README.md) From f4b044efa675cc40cc9bbdfad636c4ea258400da Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Sun, 15 Oct 2023 14:26:04 -0400 Subject: [PATCH 20/62] fix: omit trailing spaces --- translations/pt-br/README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/translations/pt-br/README.md b/translations/pt-br/README.md index 854d4d9d..4a88f6ea 100644 --- a/translations/pt-br/README.md +++ b/translations/pt-br/README.md @@ -6,10 +6,10 @@
-Bem-vindo ao curso de Introdução ao Open Source com OpenSauced! Este curso foi projetado para fornecer uma introdução ao open source e orientá-lo no processo de contribuição para projetos de open source. +Bem-vindo ao curso de Introdução ao Open Source com OpenSauced! Este curso foi projetado para fornecer uma introdução ao open source e orientá-lo no processo de contribuição para projetos de open source. ## Suporte de idioma -Assim como a pizza, open source deve ser compartilhado com todos. Clique nos links abaixo para seguir este curso nos seguintes idiomas diferentes: +Assim como a pizza, open source deve ser compartilhado com todos. Clique nos links abaixo para seguir este curso nos seguintes idiomas diferentes: [Francês](translations/fr/README.md) [Inglês](translations/fr/README.md) From cad6ded21fd0110b4e179184375e964aed58c9ab Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Sun, 15 Oct 2023 14:38:21 -0400 Subject: [PATCH 21/62] fix: revise translations --- README.md | 1 - translations/fr/README.md | 5 +++-- translations/pt-br/README.md | 4 ++-- 3 files changed, 5 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 589dffb6..86def410 100644 --- a/README.md +++ b/README.md @@ -13,7 +13,6 @@ Welcome to the Intro to Open Source Course with OpenSauced! This course is desig Like pizza, open source is meant to be shared with everyone. Click on the flags below to take this course in the following languages: [French](translations/fr/README.md) -[English](translations/fr/README.md) [Portuguese Brazilian](translations/pt-br/README.md) ## Course Overview diff --git a/translations/fr/README.md b/translations/fr/README.md index 93488877..72c97b16 100644 --- a/translations/fr/README.md +++ b/translations/fr/README.md @@ -8,9 +8,10 @@ Bienvenue dans le cours d'introduction à l'Open Source avec OpenSauced! Ce cours est conçu pour vous fournir une introduction à l'open source et vous guider tout au long du processus de contribution à des projets open source. ## Support linguistique -Comme la pizza, l'open source est destiné à être partagé avec tout le monde. Cliquez sur les liens ci-dessous pour suivre ce cours dans les différentes langues suivantes. +Comme la pizza, l'open source est destiné à être partagé avec tout le monde. Cliquez sur les drapeaux ci-dessous pour suivre ce cours dans les langues suivantes: -- [Anglais](/README.md) + [English](/README.md) + [Portuguese Brazilian](/translations/pt-br/README.md) ## Aperçu du cours diff --git a/translations/pt-br/README.md b/translations/pt-br/README.md index 4a88f6ea..ce765ee9 100644 --- a/translations/pt-br/README.md +++ b/translations/pt-br/README.md @@ -11,8 +11,8 @@ Bem-vindo ao curso de Introdução ao Open Source com OpenSauced! Este curso foi ## Suporte de idioma Assim como a pizza, open source deve ser compartilhado com todos. Clique nos links abaixo para seguir este curso nos seguintes idiomas diferentes: -[Francês](translations/fr/README.md) -[Inglês](translations/fr/README.md) +[French](/translations/fr/README.md) +[English](/README.md) ## Visão geral do curso From f4b692134e8d6d6a7d07c1afe8e810ec2e8a7c6e Mon Sep 17 00:00:00 2001 From: Christine Belzie <105683440+CBID2@users.noreply.github.com> Date: Tue, 24 Oct 2023 20:25:56 -0400 Subject: [PATCH 22/62] fix: revise tabs of the sidebar Co-authored-by: Joe Pea --- _layouts/navbar.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_layouts/navbar.md b/_layouts/navbar.md index 346c6490..b91cfc7f 100644 --- a/_layouts/navbar.md +++ b/_layouts/navbar.md @@ -2,5 +2,5 @@ * [⭐ Star The Repo](https://github.com/open-sauced/intro) * Languages * [:us: English](/) - * [:fr🇫🇷 : French](/translations/fr/) - * [:br🇧🇷 : Portuguese](/translations/pt-br/) + * [🇫🇷 French](/translations/fr/) + * [🇧🇷 Portuguese](/translations/pt-br/) From 4f9742ad4d3c3a593ce55bbfb093dea665066403 Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Tue, 24 Oct 2023 20:32:17 -0400 Subject: [PATCH 23/62] fix: omit syntax around BR flag in FR sidebar --- translations/fr/_layouts/navbar.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/translations/fr/_layouts/navbar.md b/translations/fr/_layouts/navbar.md index 2267e303..e328982f 100644 --- a/translations/fr/_layouts/navbar.md +++ b/translations/fr/_layouts/navbar.md @@ -3,4 +3,4 @@ * Langues * [:us: Anglais ](/) * [:fr: Français ](/translations/fr/) - * [:br🇧🇷: Portugais](/translations/pt-br/) + * [🇧🇷 Portugais](/translations/pt-br/) From ac3f3233d4278b226ccb12e6aa18d8fc35cdd6df Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Tue, 24 Oct 2023 20:36:00 -0400 Subject: [PATCH 24/62] fix: remove syntax and place BR last in navbar --- translations/pt-br/_layouts/navbar.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/translations/pt-br/_layouts/navbar.md b/translations/pt-br/_layouts/navbar.md index 1d49148a..4056df29 100644 --- a/translations/pt-br/_layouts/navbar.md +++ b/translations/pt-br/_layouts/navbar.md @@ -1,6 +1,6 @@ * [Pagina inicial](/) * [⭐ Marque o repositório com estrela](https://github.com/open-sauced/intro) * Idioma - * [:fr🇫🇷: Francês](/translations/fr/README.md) - * [:br🇧🇷: Português](/translations/pt-br/README.md) - * [:us: Inglês](/) \ No newline at end of file + * [🇫🇷 Francês](/translations/fr/README.md) + * [:us: Inglês](/) + * [🇧🇷 Português](/translations/pt-br/README.md) \ No newline at end of file From 7c60607f3a6e4f6f67ce4ad3430d446233833ae7 Mon Sep 17 00:00:00 2001 From: BekahHW Date: Mon, 30 Oct 2023 08:29:51 -0400 Subject: [PATCH 25/62] Update image path --- translations/pt-br/06-o-segredo-do sauce.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/translations/pt-br/06-o-segredo-do sauce.md b/translations/pt-br/06-o-segredo-do sauce.md index 7dd811cd..4b493c02 100644 --- a/translations/pt-br/06-o-segredo-do sauce.md +++ b/translations/pt-br/06-o-segredo-do sauce.md @@ -70,7 +70,8 @@ Para ser mais eficaz ao destacar suas contribuições, recomendamos o uso do seg - Verbo de sucesso + substantivo + métrica + resultado. - Exemplo: Enquanto eu estava revisando alguns pull requests para o GirlScript Summer of Code deste ano, notei que a maioria deles não seria mesclada, apesar de eu e o proprietário darmos aprovações. Então, **criei uma ação do GitHub onde os pull requests são mesclados automaticamente assim que passam pelas etapas de implantação (verbo + substantivo sucessivo)**, o que **aumentou as taxas de produtividade em 80% (métrica + resultado).** -![Adicionando um destaque ao seu perfil](../../opensauced-highlights.png) +![Adicionando um destaque ao seu perfil](../../images/opensauced-highlights.png) + **Compartilhe!**: Depois de construir um portfólio de contribuições de código aberto, você pode compartilhar seu currículo de código aberto com outras pessoas clicando no botão de compartilhamento no cabeçalho de sua página de perfil. Isso pode ser especialmente útil ao se candidatar a empregos, fazer networking com outros desenvolvedores ou promover seu trabalho na comunidade de código aberto. From 40830c4196fdda396e1bc0d4838da8092af1be07 Mon Sep 17 00:00:00 2001 From: BekahHW Date: Mon, 30 Oct 2023 08:31:50 -0400 Subject: [PATCH 26/62] Update path --- translations/pt-br/04-ferramentas-utilizadas.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/translations/pt-br/04-ferramentas-utilizadas.md b/translations/pt-br/04-ferramentas-utilizadas.md index 92fd7d8d..69443a5c 100644 --- a/translations/pt-br/04-ferramentas-utilizadas.md +++ b/translations/pt-br/04-ferramentas-utilizadas.md @@ -58,7 +58,7 @@ Para praticar o uso do GitHub, vamos passar por criar um repositório, clonar o Escollha você mesmo como o proprietário do repositório, e digite um nome para o seu repositório. Para este exemplo, usaremos `practice-repository` -![new repo screenshot](../../new-repo.png) +![new repo screenshot](../../images/new-repo.png) Escollha se você quer que seja público ou privado. Você também pode escolher inicializar o repositório com um arquivo README, um arquivo .gitignore e/ou uma licença. From e08fbfa404f28e838b7d4fd659b14f2b0372ad33 Mon Sep 17 00:00:00 2001 From: BekahHW Date: Mon, 30 Oct 2023 08:35:11 -0400 Subject: [PATCH 27/62] Rename file to follow naming conventions --- .../{06-o-segredo-do sauce.md => 06-o-segredo-do-sauce.md} | 0 translations/pt-br/_layouts/sidebar.md | 2 +- 2 files changed, 1 insertion(+), 1 deletion(-) rename translations/pt-br/{06-o-segredo-do sauce.md => 06-o-segredo-do-sauce.md} (100%) diff --git a/translations/pt-br/06-o-segredo-do sauce.md b/translations/pt-br/06-o-segredo-do-sauce.md similarity index 100% rename from translations/pt-br/06-o-segredo-do sauce.md rename to translations/pt-br/06-o-segredo-do-sauce.md diff --git a/translations/pt-br/_layouts/sidebar.md b/translations/pt-br/_layouts/sidebar.md index 33833659..8ec4ec79 100644 --- a/translations/pt-br/_layouts/sidebar.md +++ b/translations/pt-br/_layouts/sidebar.md @@ -4,7 +4,7 @@ - [Por que Open Source?](/translations/pt-br/03-por-que-open-source.md) - [Ferramentas utilizadas](/translations/pt-br/04-ferramentas-utilizadas.md) - [Como Contribuir Para Open Source](/translations/pt-br/05-como-contribuir-para-open-source.md) - - [O segredo do sauce](/translations/pt-br/06-o-molho-secreto.md) + - [O segredo do sauce](/translations/pt-br/06-o-segredo-do-sauce.md) - [Conclusão](/translations/pt-br/07-conclusão.md) - [Recursos Adicionais](/translations/pt-br/08-recursos-adicionais.md) - [Glossário](/translations/pt-br/09-glossário.md) \ No newline at end of file From fb816e9b80054e50d5c454fa6107cd251444d64a Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Mon, 30 Oct 2023 16:14:16 -0400 Subject: [PATCH 28/62] feat: updating chapter 5 of course --- .../05-como-contribuir-para-open-source.md | 20 +++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/translations/pt-br/05-como-contribuir-para-open-source.md b/translations/pt-br/05-como-contribuir-para-open-source.md index ccd33018..00ed8986 100644 --- a/translations/pt-br/05-como-contribuir-para-open-source.md +++ b/translations/pt-br/05-como-contribuir-para-open-source.md @@ -25,4 +25,24 @@ No [Discord do OpenSauced](https://discord.com/invite/U2peSNf23P), por exemplo, 4. **Aproveite o OpenSauced**: [OpenSauced](https://opensauced.pizza/) é uma plataforma que ajuda os desenvolvedores a descobrir e contribuir com projetos de open source. Ao usar o OpenSauced, você pode encontrar projetos alinhados com seus interesses, habilidades e objetivos. +### Descobrindo o Open-Source com OpenSauced + +OpenSauced é uma ferramenta poderosa para encontrar projetos de open source para contribuir. Para começar a usar o OpenSauced, siga estas etapas: + +1. **Inscreva-se para uma conta**: Visite https://www.opensauced.pizza/ e inscreva-se para uma conta usando suas credenciais do GitHub. + + ![Image](./../../images/opensauced-signup.png) + + Durante o processo de inscrição, você será solicitado a escolher alguns interesses e definir seu fuso horário. Isso ajudará o OpenSauced a recomendar projetos alinhados aos seus interesses e cronograma. + +2. **Explore o painel**: Depois de se inscrever, você será levado ao seu painel, onde poderá visualizar seus projetos, metas e contribuições atuais. Clicar em “Explorar” no cabeçalho permitirá que você navegue pelos projetos com base em seus interesses e habilidades. +3. **Pesquisar projetos**: No explorar, você pode ver uma lista de repositórios e seus níveis de atividade relevantes e níveis de engajamento que estão em alta no momento. Você também pode pesquisar projetos digitando na barra de pesquisa. Você pode pesquisar projetos por nome, descrição ou tópico e usar esta ferramenta para encontrar algo que lhe interesse. + + ![Explore](./../../images/opensauced-explore.png) + +4. **Salve projetos em seus insights**: Ao encontrar projetos de seu interesse, você pode adicioná-los às chamadas páginas "Insights", que fornecem mais detalhes sobre a atividade nos projetos. Ou, se preferir apenas mergulhar e contribuir, você pode pular para a próxima etapa. +5. **Comece a contribuir**: ao clicar no nome de um repositório, você será levado à página do GitHub, onde poderá explorar questões que estão abertas e prontas para contribuição, sabendo que a comunidade em torno deste projeto está ativo e suas contribuições serão bem-vindas. + +Ao usar o OpenSauced, você pode agilizar o processo de localização de projetos de open source para trabalhar e focar na contribuição para os projetos que se alinham aos seus interesses e objetivos. + [Próximo Capítulo ->](/translations/pt-br/06-o-segredo-do%20sauce.md) \ No newline at end of file From 6448a66b47dae8b79409ae884b5e61f2b9f7332c Mon Sep 17 00:00:00 2001 From: Antonio Pedro Date: Wed, 27 Dec 2023 17:33:38 +0530 Subject: [PATCH 29/62] docs: revised translation. Signed-off-by: Antonio Pedro --- .../pt-br/01-introdu\303\247\303\243o.md" | 10 +-- .../pt-br/04-ferramentas-utilizadas.md | 4 +- translations/pt-br/06-o-segredo-do-sauce.md | 4 - "translations/pt-br/07-conclus\303\243o.md" | 6 +- translations/pt-br/08-recursos-adicionais.md | 2 +- "translations/pt-br/09-gloss\303\241rio.md" | 75 ++++--------------- 6 files changed, 27 insertions(+), 74 deletions(-) diff --git "a/translations/pt-br/01-introdu\303\247\303\243o.md" "b/translations/pt-br/01-introdu\303\247\303\243o.md" index 66f330e0..b53d3522 100644 --- "a/translations/pt-br/01-introdu\303\247\303\243o.md" +++ "b/translations/pt-br/01-introdu\303\247\303\243o.md" @@ -2,7 +2,7 @@ Bem-vindo ao curso "Getting Started with Open Source"! Este curso abrangente irá guiá-lo pelo fascinante mundo do open source e ajudá-lo a se tornar um colaborador ativo. -Ao final deste curso, você deve ter uma compreensão sólida de como encontrar, participar e contribuir para projetos de open source, bem como como desenvolver seu currículo de open source. +Ao final deste curso, você deve ter uma compreensão sólida de como encontrar, participar e contribuir para projetos de open source, bem como desenvolver o seu currículo de open source. Mas primeiro, vamos preparar o cenário discutindo os pré-requisitos, objetivos e expectativas para este curso. ## Pré-requisitos @@ -17,13 +17,13 @@ Se você ainda não está familiarizado com o Git e o GitHub, recomendamos que v ## Objetivos -Ao longo deste curso, nossos principais objetivos são ajudá-lo a: +Ao longo deste curso, os nossos principais objetivos são ajudá-lo a: 1. **Entender o open source e seus benefícios**: exploraremos o conceito de open source, sua história e as inúmeras vantagens de contribuir para projetos de open source. 2. **Aprenda a encontrar projetos de open source**: descobrir projetos que se alinham com seus interesses e habilidades é crucial para uma experiência de open source gratificante. Apresentaremos a você ferramentas e técnicas para encontrar projetos para contribuir. 3. **Dominar as ferramentas e processos para contribuir**: forneceremos uma visão geral das ferramentas e processos essenciais para uma colaboração de open source bem-sucedida, como controle de versão, revisão de código e plataformas de comunicação. 4. **Adquira experiência prática**: seguindo exemplos e demonstrações, você terá a oportunidade de praticar suas habilidades e ganhar confiança em sua capacidade de contribuir para projetos de open source. -5. **Desenvolva seu currículo de open source**: mostrar suas contribuições de open source é vital para construir sua reputação na comunidade e demonstrar sua experiência para potenciais empregadores ou clientes. Discutiremos estratégias para desenvolver e manter seu currículo de open source. +5. **Desenvolva o seu currículo de open source**: mostrar as suas contribuições de open source é vital para construir sua reputação na comunidade e demonstrar sua experiência para potenciais empregadores ou clientes. Discutiremos estratégias para desenvolver e manter seu currículo de open source. ## Expectativas @@ -36,7 +36,7 @@ Tenha em mente que quanto mais você contribuir para projetos de open source, ma 2. **A paciência é fundamental**: tornar-se proficiente em colaboração de open source leva tempo e esforço. Não se desanime se encontrar desafios ao longo do caminho; lembre-se de que toda contribuição, por menor que seja, é valiosa e ajuda a melhorar o projeto. 3. **Engajamento com a comunidade**: o open source é mais do que apenas código; trata-se das pessoas que colaboram e contribuem para projetos. Engaje-se com a comunidade fazendo perguntas, compartilhando seu conhecimento e apoiando os outros. -Construir relacionamentos com outros colaboradores aprimorará sua experiência de open source e ajudará você a crescer como desenvolvedor. +Construir relacionamentos com outros colaboradores aprimorará a sua experiência de open source e ajudará você a crescer como desenvolvedor. 4. **Aprendizado contínuo**: o open source é um campo em rápida evolução, com novos projetos, ferramentas e tecnologias surgindo o tempo todo. Mantenha-se curioso e aberto para aprender, e aproveite os recursos, como documentação, tutoriais e fóruns da comunidade, para expandir seus conhecimentos e se manter atualizado com os últimos desenvolvimentos. @@ -47,7 +47,7 @@ Construir relacionamentos com outros colaboradores aprimorará sua experiência Este curso é dividido em vários capítulos, cada um projetado para cobrir um aspecto específico da colaboração de open source: 1. **Introdução:** Começaremos preparando o cenário para sua jornada de open source, discutindo pré-requisitos, objetivos e expectativas. -2. **O que é open source?:** Neste capítulo, exploraremos a definição de open source e sua história, fornecendo uma base sólida para entender o contexto da colaboração de open source. +2. **O que é open source?:** Neste capítulo, exploraremos a definição de open source e a sua história, fornecendo uma base sólida para entender o contexto da colaboração de open source. 3. **Por que open source?:** Vamos mergulhar nos benefícios do open source, incluindo acesso ao conhecimento, comunidade e desenvolvimento de habilidades. 4. **Ferramentas para ter sucesso:** Este capítulo apresentará as ferramentas essenciais para uma colaboração de open source bem-sucedida, incluindo GitHub, Git, CodeSee, VS Code e Discord. 5. **Como contribuir para o open source:** Neste capítulo, discutiremos o processo de encontrar projetos para trabalhar, enviar contribuições, embarcar em um novo projeto e o que esperar depois que sua contribuição for enviada. diff --git a/translations/pt-br/04-ferramentas-utilizadas.md b/translations/pt-br/04-ferramentas-utilizadas.md index 69443a5c..71238aab 100644 --- a/translations/pt-br/04-ferramentas-utilizadas.md +++ b/translations/pt-br/04-ferramentas-utilizadas.md @@ -21,8 +21,8 @@ Git é um sistema de controlo de versão distribuído projetado para lidar com p Git permite que os desenvolvedores acompanhem as alterações no seu código, colaborem com outros desenvolvedores e gerenciem várias versões dos seus projetos. Alguns dos recursos principais do Git incluem: -- **Ramificação**: Git permite que os desenvolvedores criem ramificações, cópias separadas da sua base de código. Isso permite que eles trabalhem em novos recursos ou correções de bugs sem afetar a base de código principal. Uma vez que as alterações estejam concluídas, eles podem mesclar a ramificação de volta para a base de código principal. -- **Área de preparação**: Git fornece uma área de preparação onde os desenvolvedores podem preparar as suas alterações antes de as comprometerem com o repositório. Isso permite que eles revisem e organizem as suas alterações antes de as tornarem permanentes. +- **Branch**: Git permite que os desenvolvedores criem ramificações, cópias separadas da sua base de código. Isso permite que eles trabalhem em novos recursos ou correções de bugs sem afetar a base de código principal. Uma vez que as alterações estejam concluídas, eles podem mesclar a ramificação de volta para a base de código principal. +- **Área de preparação(Stagging area)**: Git fornece uma área de preparação onde os desenvolvedores podem preparar as suas alterações antes de as comprometerem com o repositório. Isso permite que eles revisem e organizem as suas alterações antes de as tornarem permanentes. - **Controle de versão distribuído**: Ao contrário dos sistemas de controlo de versão centralizados, o Git é um sistema de controlo de versão distribuído. Isso significa que cada desenvolvedor tem uma cópia completa do repositório na máquina local, permitindo-lhes trabalhar offline e independentemente de um servidor central. ### Introdução ao GitHub diff --git a/translations/pt-br/06-o-segredo-do-sauce.md b/translations/pt-br/06-o-segredo-do-sauce.md index 4b493c02..f2c00949 100644 --- a/translations/pt-br/06-o-segredo-do-sauce.md +++ b/translations/pt-br/06-o-segredo-do-sauce.md @@ -1,16 +1,13 @@ # O segredo do sauce - Neste capítulo, vamos compartilhar algumas estratégias e dicas menos conhecidas para causar um impacto duradouro na comunidade de código aberto. Discutiremos como focar em issues abertos, ganhar tração em suas contribuições e desenvolver seu currículo de código aberto usando o OpenSauced. ## Isues abertos, mais do que PRs que corrigem erros de digitação - Enquanto corrigir erros de digitação e melhorar a documentação são contribuições valiosas para projetos de código aberto, é essencial olhar além desses frutos de baixo nível e focar na resolução de issues abertos. Abordar issues abertos não apenas ajuda o projeto a avançar, mas também permite que você desenvolva uma compreensão mais profunda da base de código e demonstre suas habilidades de resolução de issues. Aqui estão algumas dicas para encontrar e resolver abrir issues: - 1. **Navegue no rastreador de issues**: A maioria dos projetos de código aberto usa um rastreador de issues para gerenciar bugs, solicitações de recursos e outras tarefas. Navegue no rastreador de issues para encontrar issues que se alinhem com seus interesses e habilidades. 2. **Procure por issues amigáveis para iniciantes**: Muitos projetos usam rótulos como "bom primeiro issue" ou "ajuda desejada" para indicar issues que são adequados para iniciantes. Comece com esses issues para construir sua confiança e ganhar experiência antes de abordar tarefas mais complexas. @@ -35,7 +32,6 @@ Enquanto você ganha mais experiência em contribuições de código aberto, pod 4. **Compartilhe seu conhecimento**: Compartilhe seu conhecimento e insights escrevendo postagens de blog, criando tutoriais ou dando apresentações sobre os projetos em que trabalha. Isso não apenas ajudará os outros a aprender com suas experiências, mas também o estabelecerá como um líder de pensamento na comunidade de código aberto. - 5. **Mentore novos colaboradores**: À medida que você ganha mais experiência em contribuições de código aberto, considere orientar novos colaboradores que estão começando sua jornada de código aberto. Isso pode ajudá-lo a retribuir à comunidade, desenvolver suas habilidades de liderança e construir uma reputação positiva. ## Desenvolva seu currículo de código aberto diff --git "a/translations/pt-br/07-conclus\303\243o.md" "b/translations/pt-br/07-conclus\303\243o.md" index cf73fb4a..62cbe830 100644 --- "a/translations/pt-br/07-conclus\303\243o.md" +++ "b/translations/pt-br/07-conclus\303\243o.md" @@ -6,9 +6,9 @@ Como concluímos este curso sobre como começar com open source, vamos recapitul Ao longo deste curso, cobrimos uma variedade de tópicos projetados para ajudá-lo a entender e navegar pelo mundo do open source: -1. **O que é open source?**: Discutimos a definição de open source, sua história e os princípios básicos que orientam o movimento open source. +1. **O que é open source?**: discutimos a definição de open source, sua história e os princípios básicos que orientam o movimento open source. -2. **Por que open source?**: Exploramos os benefícios de se envolver com projetos de open source, incluindo acesso ao conhecimento, comunidade e desenvolvimento de habilidades. +2. **Por que open source?**: exploramos os benefícios de se envolver com projetos de open source, incluindo acesso ao conhecimento, comunidade e desenvolvimento de habilidades. 3. **Ferramentas para ter sucesso**: Apresentamos ferramentas e plataformas essenciais para colaboradores de open source, como GitHub, Git, CodeSee, Visual Studio Code e Discord. @@ -18,7 +18,7 @@ Ao longo deste curso, cobrimos uma variedade de tópicos projetados para ajudá- Ao entender esses conceitos e aplicar as estratégias que discutimos, você estará bem equipado para embarcar em uma jornada de open source bem-sucedida. -# O que vem a seguir? +# O que segue? Com o conhecimento e as ferramentas que você adquiriu neste curso, você está pronto para mergulhar no mundo do open source e começar a fazer contribuições significativas. Aqui estão alguns próximos passos para ajudá-lo a continuar sua jornada de open source: diff --git a/translations/pt-br/08-recursos-adicionais.md b/translations/pt-br/08-recursos-adicionais.md index 5ff6e1c0..71098571 100644 --- a/translations/pt-br/08-recursos-adicionais.md +++ b/translations/pt-br/08-recursos-adicionais.md @@ -18,7 +18,7 @@ Felicitações por sua jornada no open source! Aqui estão alguns recursos para - [Além da Criação de Conteúdo: Como as Contribuições de Open Source Podem Ajudá-lo a Ser Notado](https://dev.to/opensauced/beyond-content-creation-how-open-source-contributions-can-help-you-get-noticed-4l5n) -- [Escrevendo sua primeira Pull Request: Dicas, Melhores Práticas e Ferramentas com Inteligência Artificial para o Sucesso](https://dev.to/opensauced/writing-your-first-pull-request-tips-best-practices-and-ai-powered-tools-for-success-3bg9) +- [Escrevendo a sua primeira Pull Request: Dicas, Melhores Práticas e Ferramentas com Inteligência Artificial para o Sucesso](https://dev.to/opensauced/writing-your-first-pull-request-tips-best-practices-and-ai-powered-tools-for-success-3bg9) - [Como Contribuir para Open Source sem Saber Programar: Um guia com sugestões de projetos](https://dev.to/opensauced/how-to-contribute-to-open-source-without-knowing-how-to-code-a-guide-with-project-suggestions-59e5) diff --git "a/translations/pt-br/09-gloss\303\241rio.md" "b/translations/pt-br/09-gloss\303\241rio.md" index 9b14d18c..a4dc7c7c 100644 --- "a/translations/pt-br/09-gloss\303\241rio.md" +++ "b/translations/pt-br/09-gloss\303\241rio.md" @@ -1,18 +1,18 @@ ## Repositório -Um repositório é um local central onde o código é armazenado e gerenciado. Em open source, os repositórios geralmente são hospedados em plataformas como GitHub, GitLab ou Bitbucket. Cada repositório pode conter um ou mais projetos, e os contribuidores podem enviar alterações no código fazendo solicitações pull. +Um repositório é um local central onde o código é armazenado e gerenciado. Em open source, os repositórios são geralmente hospedados em plataformas como GitHub, GitLab ou Bitbucket. Cada repositório pode conter um ou mais projetos, e os contribuidores podem enviar alterações no código fazendo solicitações pull. ## Mantenedor -Um mantenedor é uma pessoa ou um grupo de pessoas responsável por manter um projeto de open source específico. Os mantenedores são normalmente responsáveis ​​por revisar e aceitar ou rejeitar as contribuições de outros contribuidores. Eles também têm autoridade para tomar as decisões finais sobre a direção e o escopo do projeto. +Um mantenedor é uma pessoa ou um grupo de pessoas responsável por manter um projeto de open source específico. Os mantenedores são normalmente responsáveis por revisar e aceitar ou rejeitar as contribuições de outros contribuidores. Eles também têm autoridade para tomar as decisões finais sobre a direção e o escopo do projeto. ## Membro Principal -Um membro principal é um colaborador que recebeu privilégios ou responsabilidades adicionais em um projeto de open source. Os membros principais geralmente são colaboradores confiáveis ​​que demonstraram um profundo conhecimento do projeto e fizeram contribuições significativas para o seu desenvolvimento. +Um membro principal é um colaborador que recebeu privilégios ou responsabilidades adicionais num projeto de open source. Os membros principais geralmente são colaboradores confiáveis que demonstraram um profundo conhecimento do projeto e fizeram contribuições significativas para o seu desenvolvimento. -## Emitir +## Issue -Um problema é um problema ou bug que precisa ser resolvido no código. Os problemas podem ser criados por qualquer pessoa e geralmente são usados ​​para rastrear bugs, solicitações de recursos e outras tarefas que precisam ser executadas. +Um problema é um problema ou ‘bug’ que precisa ser resolvido no código. Os problemas podem ser criados por qualquer pessoa e são geralmente usados para rastrear ‘bugs’, solicitações de recursos e outras tarefas que precisam ser executadas. # Contribuidor @@ -20,69 +20,26 @@ Um colaborador é qualquer pessoa que faz alterações, acréscimos ou sugestõe ## Clonar -A clonagem é o processo usado para copiar um repositório Git existente para um novo diretório local. O comando `git clone` criará um novo diretório local para o repositório, copiará todo o conteúdo do repositório especificado, criará os branches rastreados remotos e fará o checkout de um branch inicial localmente. Por padrão, o clone do Git criará uma referência ao repositório remoto chamado origin. +A clonagem é o processo usado para copiar um repositório Git existente para um novo diretório local. O comando `git clone` criará um diretório local para o repositório, copiará todo o conteúdo do repositório especificado, criará os branches rastreados remotos e fará o registo de saída de um branch inicial localmente. Por padrão, o clone do Git criará uma referência ao repositório remoto chamado origin. -## Garfo +## Fork -Uma bifurcação é uma cópia de um repositório. Ao bifurcar um repositório, você cria uma nova cópia da base de código que pode modificar e experimentar sem afetar a base de código original. +Um fork é uma cópia de um repositório. Ao bifurcar um repositório, você cria uma cópia da base de código que pode modificar e experimentar sem afetar a base de código original. -## Filial +## Branch -Uma ramificação é uma versão separada do código criada para fins de desenvolvimento. As ramificações permitem que os contribuidores experimentem as alterações sem afetar a base de código principal. Quando as alterações estão prontas para serem mescladas na base de código principal, elas geralmente são enviadas como uma pull request. +Uma branch é uma versão separada do código criada para fins de desenvolvimento. As ramificações permitem que os contribuidores experimentem as alterações sem afetar a base de código principal. Quando as alterações estão prontas para serem mescladas na base de código principal, elas são geralmente enviadas como um pull request. -## Solicitação de pull +## Pull Request -Uma solicitação pull é uma solicitação de um contribuidor a um mantenedor para que as alterações feitas no código sejam inseridas em uma base de código. +Um Pull Request é uma solicitação de um contribuidor a um mantenedor para que as alterações feitas no código sejam inseridas numa base de código. -## Mesclar +## Merge -Mesclar é o processo de combinar alterações de uma ramificação em outra. Quando uma solicitação pull é aceita e mesclada, as alterações feitas na solicitação pull tornam-se parte da base de código principal. +Merge é o processo de combinar alterações de uma ramificação em outra. Quando uma solicitação pull é aceite e mesclada, as alterações feitas na solicitação pull tornam-se parte da base de código principal. -## Documentos - -Esta é uma abreviação da palavra documentação, um pedaço de texto que fornece informações sobre como contribuir para projetos OSS e expectativas para contribuidores. Markdown, uma linguagem de codificação baseada em texto, é frequentemente usada para criar essas formas de conteúdo. Quer ver um em ação? Confira o [Guia de estilo em nosso repositório Pizza Verse](https://github.com/open-sauced/pizza-verse/blob/main/style-guide.md)! -Esta é uma abr## Repositório - -Um repositório é um local central onde o código é armazenado e gerenciado. Em open source, os repositórios geralmente são hospedados em plataformas como GitHub, GitLab ou Bitbucket. Cada repositório pode conter um ou mais projetos, e os contribuidores podem enviar alterações no código fazendo solicitações pull. - -## Mantenedor - -Um mantenedor é uma pessoa ou um grupo de pessoas responsável por manter um projeto de open source específico. Os mantenedores são normalmente responsáveis ​​por revisar e aceitar ou rejeitar as contribuições de outros contribuidores. Eles também têm autoridade para tomar as decisões finais sobre a direção e o escopo do projeto. - -## Membro Principal - -Um membro principal é um colaborador que recebeu privilégios ou responsabilidades adicionais em um projeto de open source. Os membros principais geralmente são colaboradores confiáveis ​​que demonstraram um profundo conhecimento do projeto e fizeram contribuições significativas para o seu desenvolvimento. - -## Emitir - -Um problema é um problema ou bug que precisa ser resolvido no código. Os problemas podem ser criados por qualquer pessoa e geralmente são usados ​​para rastrear bugs, solicitações de recursos e outras tarefas que precisam ser executadas. - -# Contribuidor - -Um colaborador é qualquer pessoa que faz alterações, acréscimos ou sugestões a um projeto de open source. Os colaboradores podem ser desenvolvedores, designers, escritores, testadores ou qualquer outra pessoa que ajude a tornar o projeto melhor. - -## Clonar - -A clonagem é o processo usado para copiar um repositório Git existente para um novo diretório local. O comando `git clone` criará um novo diretório local para o repositório, copiará todo o conteúdo do repositório especificado, criará os branches rastreados remotos e fará o checkout de um branch inicial localmente. Por padrão, o clone do Git criará uma referência ao repositório remoto chamado origin. - -## Garfo - -Uma bifurcação é uma cópia de um repositório. Ao bifurcar um repositório, você cria uma nova cópia da base de código que pode modificar e experimentar sem afetar a base de código original. - -## Filial - -Uma ramificação é uma versão separada do código criada para fins de desenvolvimento. As ramificações permitem que os contribuidores experimentem as alterações sem afetar a base de código principal. Quando as alterações estão prontas para serem mescladas na base de código principal, elas geralmente são enviadas como uma pull request. - -## Solicitação de pull - -Uma solicitação pull é uma solicitação de um contribuidor a um mantenedor para que as alterações feitas no código sejam inseridas em uma base de código. - -## Mesclar - -Mesclar é o processo de combinar alterações de uma ramificação em outra. Quando uma solicitação pull é aceita e mesclada, as alterações feitas na solicitação pull tornam-se parte da base de código principal. - -## Documentos +## Docs Isso é uma abreviação da palavra "documentação", um pedaço de texto que fornece informações sobre como contribuir para projetos de código aberto e expectativas para os contribuidores. O Markdown, uma linguagem de codificação baseada em texto, é frequentemente usado para criar esse tipo de conteúdo. -Quer ver um exemplo em ação? Confira o [Guia de Estilo no nosso repositório Pizza Verse](https://github.com/open-sauced/pizza-verse/blob/main/style-guide.md)! +Quer ver um exemplo em ação? Confira o [Guia de Estilo no nosso repositório Pizza Verse](https://github.com/open-sauced/pizza-verse/blob/main/style-guide.md)! \ No newline at end of file From 0c9f6b8de4c892814e3fa82e304a46d1c9b47157 Mon Sep 17 00:00:00 2001 From: Geoffrey Logovi <52314615+geoffreylgv@users.noreply.github.com> Date: Wed, 27 Dec 2023 18:15:49 +0000 Subject: [PATCH 30/62] fixe : navbar bad arrangement --- _layouts/navbar.md | 13 +++---------- translations/pt-br/_layouts/navbar.md | 4 ++-- 2 files changed, 5 insertions(+), 12 deletions(-) diff --git a/_layouts/navbar.md b/_layouts/navbar.md index 37ef0b55..5367175c 100644 --- a/_layouts/navbar.md +++ b/_layouts/navbar.md @@ -1,13 +1,6 @@ - * [Home Page](/) * [⭐ Star The Repo](https://github.com/open-sauced/intro) * Languages - * [:us: English](/) - * [🇫🇷 French](/translations/fr/) - * [🇧🇷 Portuguese](/translations/pt-br/) -- [Home Page](/) -- [⭐ Star The Repo](https://github.com/open-sauced/intro) -- Languages - - [:us: English ](/) - - [:fr: French ](/translations/fr/) - + * [:us: English](/) + * [:fr: French](/translations/fr/) + * [🇧🇷 Portuguese](/translations/pt-br/) diff --git a/translations/pt-br/_layouts/navbar.md b/translations/pt-br/_layouts/navbar.md index 4056df29..3b291ff2 100644 --- a/translations/pt-br/_layouts/navbar.md +++ b/translations/pt-br/_layouts/navbar.md @@ -2,5 +2,5 @@ * [⭐ Marque o repositório com estrela](https://github.com/open-sauced/intro) * Idioma * [🇫🇷 Francês](/translations/fr/README.md) - * [:us: Inglês](/) - * [🇧🇷 Português](/translations/pt-br/README.md) \ No newline at end of file + * [:us: Inglês](/) + * [🇧🇷 Português](/translations/pt-br/README.md) From 356bb67a3e82f7c046d216712e1f534eb20bed3a Mon Sep 17 00:00:00 2001 From: Christine Date: Wed, 27 Dec 2023 20:26:12 +0000 Subject: [PATCH 31/62] fix: rename french translations of chapters 9 & 10 --- translations/fr/{07-conclusion.md => 09-conclusion.md} | 0 translations/fr/{09-glossaire.md => 10-glossaire.md} | 0 2 files changed, 0 insertions(+), 0 deletions(-) rename translations/fr/{07-conclusion.md => 09-conclusion.md} (100%) rename translations/fr/{09-glossaire.md => 10-glossaire.md} (100%) diff --git a/translations/fr/07-conclusion.md b/translations/fr/09-conclusion.md similarity index 100% rename from translations/fr/07-conclusion.md rename to translations/fr/09-conclusion.md diff --git a/translations/fr/09-glossaire.md b/translations/fr/10-glossaire.md similarity index 100% rename from translations/fr/09-glossaire.md rename to translations/fr/10-glossaire.md From d0f52209d5b043cb020e94a16136410575747b51 Mon Sep 17 00:00:00 2001 From: Christine Date: Wed, 27 Dec 2023 20:35:10 +0000 Subject: [PATCH 32/62] feat: add french translation of chapter 7 --- .../fr/07-les-types-de-contributions.md | 99 +++++++++++++++++++ 1 file changed, 99 insertions(+) create mode 100644 translations/fr/07-les-types-de-contributions.md diff --git a/translations/fr/07-les-types-de-contributions.md b/translations/fr/07-les-types-de-contributions.md new file mode 100644 index 00000000..d6a4e96f --- /dev/null +++ b/translations/fr/07-les-types-de-contributions.md @@ -0,0 +1,99 @@ +# Types de contributions +Dans ce chapitre, nous examinerons les types de contributions non codantes et non codantes qui participent à des projets de sources ouvertes. + +## Types de contributions non codantes + Les contributions non codantes n'impliquent pas la rédaction ou la modification du code. Les contributions non codantes sont essentielles à la viabilité et à la croissance des projets de sources ouvertes. Ils permettent aux personnes ayant des compétences et des antécédents variés de participer et d'apporter des contributions significatives au logiciel et à la collectivité. + +> [Comment contribuer à l'ouverture de la source sans savoir comment code : guide avec suggestions de projet](https://dev.to/opensauced/how-to-contribute-to-open-source-without-knowing-how-to-code-a-guide-with-project-suggestions-59e5) + +**Types communs de contributions non codantes** + - Types communs de contributions non codantes + - Documentation + - Conception graphique + +### Rédaction d'un blog +Documentation + +⁇ tes-vous un tas de mots? Les erreurs grammaires vous sont-elles irritées? Aimeriez-vous briser des problèmes complexes ou aider les gens à apprendre? Ensuite, la documentation est pour vous ⁇ + +### Il s'agit de créer, d'améliorer ou de maintenir les ressources écrites qui accompagnent les projets de logiciels libres. La documentation est essentielle pour les projets de sources ouvertes. Il peut rendre un projet plus accessible et plus convivial, et il peut aider à attirer de nouveaux contributeurs et à encourager des contributions répétées. +*Comment contribuer à la documentation* + +- **Comment contribuer à la documentation**Comment contribuer à la documentation + +- **Si vous souhaitez contribuer à la documentation, voici quelques conseils :**Si vous souhaitez contribuer à la documentation, voici quelques conseils : + +- **Lisez la documentation**Lisez la documentation + +- **Cela vous aidera à comprendre comment le produit est utilisé.**Cela vous aidera à comprendre comment le produit est utilisé. +#### Trouver une tâche qui convient bien à vos compétences et à vos intérêts + + - Si vous n'êtes pas certain de commencer, examinez les questions ou les discussions avant de rejoindre un agent de maintien en poste. [Utiliser le produit](https://github.com/open-sauced/app/blob/beta/README.md) + + - La compréhension de l'utilisateur vous aidera à voir quelles informations sont nécessaires ou non utiles dans les documents. [Soyez patient et persistant](https://docs.opensauced.pizza/community/highlights/) + + - Il faut du temps pour rédiger une bonne documentation. Ne craignez pas de demander de l'aide si vous obtenez des coups. [Exemples de contributions documentaires :](https://github.com/open-sauced/docs/issues/156) + + - Rédiger un fichier READ qui explique comment installer et utiliser le projet : [Le OpenSauced App](https://github.com/open-sauced/intro/issues/16) + + - Créer un tutoriel qui marche les utilisateurs grâce aux caractéristiques du projet : [OpenSauced Faits saillants](https://github.com/StyleGuides/WritingStyleGuide/pull/519) + + - Mettre à jour la documentation du projet pour tenir compte des nouveaux changements : [Ajouter les cartes d'équipement pour commencer](https://github.com/open-sauced/docs/pull/144) + + - Transmettre la documentation du projet dans d'autres langues : [Transmettre le cours dans une autre langue](https://github.com/open-sauced/100-days-of-oss-template/pull/8) + +Fixer les typos et les erreurs grammaticales dans la documentation : + +### Ajout d'informations sur les biens matériels +Améliorer la présentation de la documentation : + - **Lien inexact Destination dans la documentation**Lien inexact Destination dans la documentation + +- **Ajouter les renseignements manquants à la documentation :**Ajouter les renseignements manquants à la documentation : [Ajouter plus d'information pour utiliser ce modèle dans la DRE](https://github.com/WebXGuild/webx-guild/pull/13) + + - **La contribution à la documentation est une bonne façon d'aider les projets de sources ouvertes et de les rendre plus accessibles à tous. Si vous avez les compétences et l'intérêt, faites-vous participer ⁇**La contribution à la documentation est une bonne façon d'aider les projets de sources ouvertes et de les rendre plus accessibles à tous. Si vous avez les compétences et l'intérêt, faites-vous participer ⁇ + +- **Conception graphique**Conception graphique + +- **Cette contribution de source ouverte implique la création d'actifs visuels, tels que logos, icônes, illustrations, conceptions de sites Web et autres éléments graphiques, pour des projets à source ouverte. Ces actifs visuels jouent un rôle important dans l'amélioration de l'expérience globale des utilisateurs et de l'image de marque du projet. Les contributions de conception graphique peuvent rendre les logiciels libres plus attrayants, plus conviviaux et plus reconnaissables.**Cette contribution de source ouverte implique la création d'actifs visuels, tels que logos, icônes, illustrations, conceptions de sites Web et autres éléments graphiques, pour des projets à source ouverte. Ces actifs visuels jouent un rôle important dans l'amélioration de l'expérience globale des utilisateurs et de l'image de marque du projet. Les contributions de conception graphique peuvent rendre les logiciels libres plus attrayants, plus conviviaux et plus reconnaissables. + +- **Logo et marques**Logo et marques + +- **La conception d'un logo unique et mémorable pour un projet de source ouverte peut contribuer à établir son identité et sa marque. Un logo bien conçu peut rendre le projet immédiatement reconnaissable et lui donner une image professionnelle.**La conception d'un logo unique et mémorable pour un projet de source ouverte peut contribuer à établir son identité et sa marque. Un logo bien conçu peut rendre le projet immédiatement reconnaissable et lui donner une image professionnelle. + +### Conception des cônes +L'Icons est essentiel pour les interfaces utilisateurs. Les concepteurs graphiques peuvent créer des icônes personnalisés pour des applications logicielles ou des sites Web, ce qui améliore l'appel visuel et l'utilité du projet : + +### Signalisation de l'événement +- Conception du site Web [Les projets à source ouverte ont souvent des sites Web pour fournir de l'information, de la documentation et télécharger des liens. Les concepteurs graphiques peuvent contribuer en concevant des schémas de site Web, des graphiques, des bannières et d'autres éléments visuels pour rendre le site plus attrayant et plus convivial.](https://dev.to/analogjs/announcing-the-020-release-of-analog-aa1) + +- Utilisateur Interface (I) Conception [Pour les projets de logiciels, UI projets sont essentiels. Les concepteurs peuvent créer des caméras, des clichés et des modèles à haute vitesse pour l'interface utilisateur, ce qui en fait un attrait plus intuitif et visuel.](https://dev.to/opensauced/how-to-make-a-delicious-contributing-guide-4bp3) + +- Expérience de l'utilisateur (X) Conception [Les concepteurs X se concentrent sur l'amélioration de l'expérience globale des utilisateurs en considérant comment les utilisateurs interagissent avec le logiciel. Cela comprend la conception des flux d'utilisateurs, la navigation et les essais d'utilisation.](https://opensauced.pizza/blog/retaining-the-best-engineers) + +- Conception de l'accessibilité [⁇ Veiller à ce que les éléments graphiques du projet soient accessibles à tous les utilisateurs, y compris les personnes handicapées, est un aspect important de la conception graphique. Les concepteurs peuvent créer des systèmes de couleur accessibles et s'assurer que les éléments visuels sont perceptibles et fonctionnent.](https://opensauced.pizza/blog/open-source-101-a-beginner's-guide-to-getting-started) + +## Conception réactive + +La conception de visions qui fonctionnent bien sur divers dispositifs et tailles d'écran est essentielle pour les applications modernes du Web. La conception réceptive permet de s'assurer que le projet est bien conçu et fonctionne correctement sur les dispositifs de bureau et les dispositifs mobiles. + +Blog Writing + +- **Ce type de contribution de source ouverte consiste à créer et à publier des postes de blog, des articles ou des tutoriels liés à des logiciels, des projets, des technologies ou des pratiques exemplaires. Comme la documentation, vous n'avez pas nécessairement à savoir comment coder ces postes.**Ce type de contribution de source ouverte consiste à créer et à publier des postes de blog, des articles ou des tutoriels liés à des logiciels, des projets, des technologies ou des pratiques exemplaires. Comme la documentation, vous n'avez pas nécessairement à savoir comment coder ces postes. [Moyens d'utiliser Blogging comme contribution à la source ouverte](https://github.com/open-sauced/app/pull/1591) + +- **Vous pouvez écrire sur les dernières caractéristiques d'un projet à source ouverte, comme une nouvelle version du logiciel ou une nouvelle embouteille :**Vous pouvez écrire sur les dernières caractéristiques d'un projet à source ouverte, comme une nouvelle version du logiciel ou une nouvelle embouteille : [Annonce de la libération d'analogie de 0,2.0](https://github.com/open-sauced/app/pull/1635) + +- **Vous pouvez écrire un tutoriel sur la façon d'installer et de configurer le logiciel :**Vous pouvez écrire un tutoriel sur la façon d'installer et de configurer le logiciel : [Comment faire un guide de contribution volontaire](https://github.com/open-sauced/app/pull/1633) + +- **Écrire l'impact d'un projet de sources ouvertes, comme la façon dont il a été utilisé pour faire une différence dans le monde :**Écrire l'impact d'un projet de sources ouvertes, comme la façon dont il a été utilisé pour faire une différence dans le monde : [Retenir les meilleurs ingénieurs](https://github.com/IridiumIdentity/iridium/pull/134) + +- **Codage et non-codage Types de contributions, tels que la façon de démarrer avec une source ouverte :**Codage et non-codage Types de contributions, tels que la façon de démarrer avec une source ouverte : [Source ouverte 101 : Un guide de Beginner pour commencer](https://github.com/TechIsHiring/techishiring-website/pull/53) + +- **Codage Type de contributions**Codage Type de contributions [Le codage des contributions favorise le développement de sources ouvertes. Il s'agit d'écrire, de modifier ou d'améliorer le code de source réel d'un projet à source ouverte, ce qui influe directement sur la fonctionnalité et la qualité du logiciel. Les participants collaborent avec les responsables du projet et la collectivité pour s'assurer que leurs contributions au code correspondent aux objectifs du projet et aux normes de codage. De plus, les projets à source ouverte ont généralement des lignes directrices et des processus pour accepter et intégrer les contributions codantes, comme l'examen des codes et l'intégration continue.](https://github.com/open-sauced/app/pull/1559) + +- **Voici quelques exemples de contributions que vous pouvez apporter à un projet avec vos compétences en codage :**Voici quelques exemples de contributions que vous pouvez apporter à un projet avec vos compétences en codage : [Rédaction du nouveau code](https://github.com/open-sauced/app/pull/1330) + +[C'est le type de contribution de codage le plus courant. Les promoteurs rédigent un nouveau code pour ajouter des caractéristiques, fixer des bouchons ou améliorer la fonctionnalité d'un projet à source ouverte. Ces contributions sont généralement présentées sous forme de demandes de coque (PRs) ou de timbres :](08-additional-resources.md) + + + ✏️ Edit this page + From 7490f27cf32da3aa10462e66e587acd46291ce1a Mon Sep 17 00:00:00 2001 From: Christine Date: Wed, 27 Dec 2023 20:37:42 +0000 Subject: [PATCH 33/62] fix: change order in portuguese translation --- .../pt-br/09-conclus\303\243o.md" | 0 .../pt-br/10-gloss\303\241rio.md" | 0 2 files changed, 0 insertions(+), 0 deletions(-) rename "translations/pt-br/07-conclus\303\243o.md" => "translations/pt-br/09-conclus\303\243o.md" (100%) rename "translations/pt-br/09-gloss\303\241rio.md" => "translations/pt-br/10-gloss\303\241rio.md" (100%) diff --git "a/translations/pt-br/07-conclus\303\243o.md" "b/translations/pt-br/09-conclus\303\243o.md" similarity index 100% rename from "translations/pt-br/07-conclus\303\243o.md" rename to "translations/pt-br/09-conclus\303\243o.md" diff --git "a/translations/pt-br/09-gloss\303\241rio.md" "b/translations/pt-br/10-gloss\303\241rio.md" similarity index 100% rename from "translations/pt-br/09-gloss\303\241rio.md" rename to "translations/pt-br/10-gloss\303\241rio.md" From fb06f854c1c0d907a5be4605a1ceba0c73da860e Mon Sep 17 00:00:00 2001 From: Christine Date: Wed, 27 Dec 2023 20:40:51 +0000 Subject: [PATCH 34/62] fix: revise order of Portuguese sidebar --- translations/pt-br/_layouts/sidebar.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/translations/pt-br/_layouts/sidebar.md b/translations/pt-br/_layouts/sidebar.md index 8ec4ec79..6344b083 100644 --- a/translations/pt-br/_layouts/sidebar.md +++ b/translations/pt-br/_layouts/sidebar.md @@ -5,6 +5,6 @@ - [Ferramentas utilizadas](/translations/pt-br/04-ferramentas-utilizadas.md) - [Como Contribuir Para Open Source](/translations/pt-br/05-como-contribuir-para-open-source.md) - [O segredo do sauce](/translations/pt-br/06-o-segredo-do-sauce.md) - - [Conclusão](/translations/pt-br/07-conclusão.md) - - [Recursos Adicionais](/translations/pt-br/08-recursos-adicionais.md) - - [Glossário](/translations/pt-br/09-glossário.md) \ No newline at end of file + - [Recursos Adicionais](/translations/pt-br/08-recursos-adicionais.md) + - [Conclusão](/translations/pt-br/09-conclusão.md) + - [Glossário](/translations/pt-br/10-glossário.md) \ No newline at end of file From b5fc9d0e43c833caaa68ad67aa878e4f229676e7 Mon Sep 17 00:00:00 2001 From: Christine Date: Wed, 27 Dec 2023 20:43:07 +0000 Subject: [PATCH 35/62] fix: change order of French sidebar --- translations/fr/_layouts/sidebar.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/translations/fr/_layouts/sidebar.md b/translations/fr/_layouts/sidebar.md index 788e1994..c32f4de9 100644 --- a/translations/fr/_layouts/sidebar.md +++ b/translations/fr/_layouts/sidebar.md @@ -5,6 +5,7 @@ - [Outils pour réussir](/translations/fr/04-outils-pour-reussir.md) - [Comment contribuer à l'open source](/translations/fr/05-comment-contribuer-à-l-open-source.md) - [La sauce secrète](/translations/fr/06-la-sauce-secrète.md) - - [Conclusion](/translations/fr/07-conclusion.md) + - [Les types de contributions](/translations/fr/07-les-types-de-contributions.md) - [Ressources Additionnelles](/translations/fr/08-ressources-additionnelles.md) - - [Glossaire](/translations/fr/09-glossaire.md) + - [Conclusion](/translations/fr/09-conclusion.md) + - [Glossaire](/translations/fr/10-glossaire.md) From 80bc8568442b179ad11157b8dc41b53543585078 Mon Sep 17 00:00:00 2001 From: Christine Date: Wed, 27 Dec 2023 20:51:41 +0000 Subject: [PATCH 36/62] fix: revise formatting of sidebar --- translations/pt-br/_layouts/sidebar.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/translations/pt-br/_layouts/sidebar.md b/translations/pt-br/_layouts/sidebar.md index 6344b083..962e01bc 100644 --- a/translations/pt-br/_layouts/sidebar.md +++ b/translations/pt-br/_layouts/sidebar.md @@ -5,6 +5,6 @@ - [Ferramentas utilizadas](/translations/pt-br/04-ferramentas-utilizadas.md) - [Como Contribuir Para Open Source](/translations/pt-br/05-como-contribuir-para-open-source.md) - [O segredo do sauce](/translations/pt-br/06-o-segredo-do-sauce.md) - - [Recursos Adicionais](/translations/pt-br/08-recursos-adicionais.md) + - [Recursos Adicionais](/translations/pt-br/08-recursos-adicionais.md) - [Conclusão](/translations/pt-br/09-conclusão.md) - [Glossário](/translations/pt-br/10-glossário.md) \ No newline at end of file From 9fe7ca8000e96112173f6023dd90cb656073d17b Mon Sep 17 00:00:00 2001 From: Christine Date: Wed, 27 Dec 2023 21:33:04 +0000 Subject: [PATCH 37/62] feat: add Brazilian translation of chapter 7 --- ...tipos-de-contribuic\314\247o\314\203es.md" | 114 ++++++++++++++++++ 1 file changed, 114 insertions(+) create mode 100644 "translations/pt-br/07-tipos-de-contribuic\314\247o\314\203es.md" diff --git "a/translations/pt-br/07-tipos-de-contribuic\314\247o\314\203es.md" "b/translations/pt-br/07-tipos-de-contribuic\314\247o\314\203es.md" new file mode 100644 index 00000000..fd44e3d4 --- /dev/null +++ "b/translations/pt-br/07-tipos-de-contribuic\314\247o\314\203es.md" @@ -0,0 +1,114 @@ +# Tipos de contribuições + +Neste capítulo, discutiremos os tipos de contribuições que não são de codificação e de codificação envolvidos em projetos de código aberto. + +## Tipo de Não Codificação de Contribuições + +Contribuições não-codificadas não envolvem escrever ou modificar o código. Contribuições não codificadas são essenciais para a sustentabilidade e o crescimento de projetos de código aberto. Eles permitem que indivíduos com diversas habilidades e antecedentes participem e façam contribuições significativas para o software e a comunidade. + +> [Como Contribuir com Código Aberto sem Saber Como Código: um guia com sugestões de projeto](https://dev.to/opensauced/how-to-contribute-to-open-source-without-knowing-how-to-code-a-guide-with-project-suggestions-59e5) + +**Tipos comuns de contribuições não codificadas** + +- Documentação +- Design gráfico +- Escrever blog + +### Documentação + +Você é um amante de palavras? Os erros gramaticais te irritam? Você gosta de resolver problemas complexos ou de ajudar as pessoas a aprender? Então a documentação será para você! + +Isso envolve criar, melhorar ou manter os recursos escritos que acompanham projetos de software de código aberto. Documentação é crucial para projetos de código aberto. Ele pode tornar um projeto mais acessível e fácil de usar, e pode ajudar a atrair novos contribuidores e incentivar contribuições repetidas. + +### Como Contribuir com a Documentação + +_Se você estiver interessado em contribuir com a documentação, aqui estão algumas dicas:_ + +- **Leia a documentação**: isso vai te ajudar a entender como o produto é usado. + +- **Encontre uma tarefa que seja boa para suas habilidades e interesses**: Se você não tem certeza de por onde começar, dê uma olhada nos problemas ou discussões antes de chegar a um mantenedor. + +- **Use o produto**: adquirir informações irá ajudá-lo a ver quais informações são necessárias ou não úteis na documentação. + +- **Seja paciente e persistente**: leva tempo para escrever uma boa documentação. Não tenha medo de pedir ajuda se você ficar preso. + +#### Exemplos de contribuições de documentação: + +- Escreva um arquivo README que explique como instalar e usar o projeto: O OpenSauced App + + +- Crie um tutorial que oriente os usuários através dos recursos do projeto: [Recurso de Destaques OpenSauced](https://docs.opensauced.pizza/community/highlights/) + +- Atualize a documentação do projeto para refletir as novas alterações: [Adicionar Cartões Dev a Introdução](https://github.com/open-sauced/docs/issues/156) + +- Traduza a documentação do projeto para outros idiomas: [Traduza o curso para outro idioma](https://github.com/open-sauced/intro/issues/16) + +- Corrigir erros de digitação e gramatical na documentação: Adicionando informações sobre possessives + + +- Melhore a formatação da documentação: [Destino incorreto do Link na Documentação](https://github.com/open-sauced/docs/pull/144) + +- Adicione informações faltando à documentação: [Adicionar mais informações para usar esse modelo no README](https\://github.com/open-sauced/100-days -of-oss-template/pull/8) + +Contribuir para a documentação é uma ótima maneira de ajudar projetos de código aberto e torná-los mais acessíveis para todos. Se você tiver as habilidades e o interesse, envolva-se! + +### Design gráfico + +Esta contribuição de código aberto envolve a criação de recursos visuais, como logotipos, ícones, ilustrações, projetos de sites e outros elementos gráficos, para projetos de código aberto. Esses recursos visuais desempenham um papel significativo no aprimoramento da experiência e da marca do usuário em geral do projeto. Contribuições de design gráficas podem tornar software de código aberto mais atraente, amigável e reconhecível. + +- **Logotipo e Marca**: conceber um logotipo único e memorável para um projeto de código aberto pode ajudar a estabelecer sua identidade e marca. Um logotipo bem projetado pode tornar o projeto imediatamente reconhecível e dar-lhe uma imagem profissional. + +- **Design de Ícone**: os ícones são essenciais para interfaces de usuário. Designers gráficos podem criar ícones personalizados para softwares aplicativos ou websites, melhorando a atração visual e usabilidade do projeto: [Inscrição no Eventhub](https://github.com/WebXGuild/webx-guild/pull/13) + +- **Design do Site**: Projetos de código aberto geralmente possuem sites para fornecer informações, documentação e links de download. Designers gráficos podem contribuir projetando layouts do site, gráficos, banners e outros elementos visuais para tornar o site mais atraente e fácil de usar. + +- **Design da interface de usuário (interface do usuário**: para projetos de software, design da interface do usuário é crucial. Designers podem criar mockups, wireframe e desenhos de alta fidelidade para a interface do usuário, tornando-o mais intuitivo e visualmente atraente. + +- **Design de Experiência do Usuário (UX)**: Designers de UX focam em melhorar a experiência geral do usuário, considerando como os usuários interagem com o software. Isso inclui projetar fluxos de usuário, navegação e testes de usabilidade. + +- **Design de Acessibilidade**: Garantir que os elementos gráficos do projeto estejam acessíveis para todos os usuários, incluindo aqueles com deficiência, é um aspecto importante do design gráfico. Os designers podem criar esquemas de cores acessíveis e garantir que os elementos visuais sejam perceptíveis e operacionais. + +- **Design responsivo**: Projetar visuais que funcionam bem em vários dispositivos e tamanhos de tela é crucial para aplicações web modernas. Design responsivo garante que o projeto parece ser bom e funciona corretamente tanto no computador quanto em dispositivos móveis. + +### Escrever blog + +Esse tipo de contribuição de código aberto envolve a criação e publicação de postagens, artigos ou tutoriais relacionados a software de código aberto, projetos, tecnologias ou melhores práticas. Como documentação, você não precisa necessariamente saber como programar para escrever esses posts. + +### Formas de usar o Blogging como uma contribuição de código aberto + +- Você pode escrever sobre os últimos recursos de um projeto open-source, como uma nova versão do software ou um novo plugin: [Anunciando o 0..0 release of Analog](https://dev.to/analogjs/announcing-the-020-release-of-analog-aa1) + +- Você pode escrever um tutorial sobre como instalar e configurar o software: [Como Criar um Delicioso Guia de Contribuição](https://dev.to/opensauced/how-to-make-a-delicious-contributing-guide-4bp3) + +- Escreva sobre o impacto de um projeto de código aberto, como ele tem sido usado para fazer a diferença no mundo: [Manter os melhores engenheiros](https\://opensauced. izza/blog/retaining-the-best-engineers) + +- Tipos de Codificação e Não-codificação de Contribuições, como como começar com código aberto: [Código Aberto 101: Um guia para Iniciantes de Começar](https://opensauced.pizza/blog/open-source-101-a-beginner's-guide-to-getting-started) + +## Tipo de Não Codificação de Contribuições + +Contribuições de codificação impulsionam o desenvolvimento open-source. Eles implicam escrever, modificar ou melhorar o código-fonte real de um projeto de código aberto, afetando diretamente a funcionalidade e a qualidade do software. Colaboradores colaboram com mantenedores de projetos e com a comunidade para garantir que suas contribuições de código estejam alinhadas com objetivos de projeto e padrões de codificação. Além disso, os projetos de código aberto normalmente têm diretrizes e processos de aceitar e integrar as contribuições de código, como revisões de código aberto e integração contínua. + +Aqui estão alguns exemplos de contribuições que você pode fazer em um projeto com suas habilidades de codificação: + +- **Escrevendo novo código**: esse é o tipo de contribuição de programação mais comum. Desenvolvedores escrevem um novo código para adicionar recursos, corrigir bugs ou melhorar a funcionalidade de um projeto de código aberto. Estas contribuições são normalmente enviadas na forma de pull requests (pull requests) ou patches: [Exibir quem reagiu aos highlights](https://github.com/open-sauced/app/pull/1591) + +- **Correções de bugs**: identificar e corrigir bugs é uma contribuição crítica para a codificação. Desenvolvedores localizam problemas na base de código, diagnosticam o problema e depois escrevem o código para corrigi-lo. Correções de bugs melhoram a estabilidade e a confiabilidade do software: Verifique o Lint acontecendo duas vezes no commit + + +- **Refatoração de Código**: refatoração envolve reestruturação e melhoria do código existente sem mudar seu comportamento externo. Isso ajuda a melhorar a legibilidade de código, manutenção e escalabilidade, que são vitais para a saúde a longo prazo do projeto: [função CalcDistanceFromNow](https://github.com/open-sauced/app/pull/1633) + +- **Design e Manutenção de API**: Para projetos com API pública, os desenvolvedores podem contribuir para projetar, manter, e melhorar a API para garantir que ela permaneça estável e amigável para o desenvolvedor: [Atualizar token + ](https\://github. Um/IridiumIdentidade/iridium/pull/134) + +- **Desenvolvimento de recursos**: Os desenvolvedores contribuem implementando novos recursos ou funcionalidades em resposta às necessidades do usuário ou objetivos do projeto. O desenvolvimento de recursos geralmente envolve planejamento, design e codificação de novos componentes ou recursos : Adicionado a página de contato + + +- **Otimização de desempenho**: Os codificadores podem trabalhar na otimização do desempenho do software refatorando o código, melhorando os algoritmos ou otimizando o uso de recursos. Este tipo de contribuição visa fazer o software funcionar mais eficientemente: [Tabela de repos em telas pequenas não mostra seleto](https://github.com/open-sauced/app/pull/1559) + +- **Teste e Garantia de Qualidade**: Escrever testes automatizados, incluindo testes de unidade, testes de integração e testes de ponta a ponta, é uma contribuição de codificação que garante confiabilidade do software. Testar ajuda a capturar e prevenir regressões e problemas: [Adicionar componente de login forçado para projetar o sistema](https://github.com/open-sauced/app/pull/1330) + +[Próxima Seção ->](08-adicional-resources.md) + + + ✏️ Edite esta página + From 9c2658deb892b9e161451301d91411ee21f40e17 Mon Sep 17 00:00:00 2001 From: Christine Date: Wed, 27 Dec 2023 21:34:21 +0000 Subject: [PATCH 38/62] feat: revise order of sidebar --- translations/pt-br/_layouts/sidebar.md | 1 + 1 file changed, 1 insertion(+) diff --git a/translations/pt-br/_layouts/sidebar.md b/translations/pt-br/_layouts/sidebar.md index 962e01bc..f8ae689d 100644 --- a/translations/pt-br/_layouts/sidebar.md +++ b/translations/pt-br/_layouts/sidebar.md @@ -5,6 +5,7 @@ - [Ferramentas utilizadas](/translations/pt-br/04-ferramentas-utilizadas.md) - [Como Contribuir Para Open Source](/translations/pt-br/05-como-contribuir-para-open-source.md) - [O segredo do sauce](/translations/pt-br/06-o-segredo-do-sauce.md) + - [Tipos de contribuições](/translations/pt-br/07-tipos-de-contribuições.md) - [Recursos Adicionais](/translations/pt-br/08-recursos-adicionais.md) - [Conclusão](/translations/pt-br/09-conclusão.md) - [Glossário](/translations/pt-br/10-glossário.md) \ No newline at end of file From d39f50ab5e41f6e2f6ef608f0ccd97455eb07b15 Mon Sep 17 00:00:00 2001 From: Antonio Pedro Date: Thu, 28 Dec 2023 17:24:26 +0530 Subject: [PATCH 39/62] docs: revised translation of part 7 Signed-off-by: Antonio Pedro --- ...tipos-de-contribuic\314\247o\314\203es.md" | 20 ++++++------------- 1 file changed, 6 insertions(+), 14 deletions(-) diff --git "a/translations/pt-br/07-tipos-de-contribuic\314\247o\314\203es.md" "b/translations/pt-br/07-tipos-de-contribuic\314\247o\314\203es.md" index fd44e3d4..6f5fc05f 100644 --- "a/translations/pt-br/07-tipos-de-contribuic\314\247o\314\203es.md" +++ "b/translations/pt-br/07-tipos-de-contribuic\314\247o\314\203es.md" @@ -4,7 +4,7 @@ Neste capítulo, discutiremos os tipos de contribuições que não são de codif ## Tipo de Não Codificação de Contribuições -Contribuições não-codificadas não envolvem escrever ou modificar o código. Contribuições não codificadas são essenciais para a sustentabilidade e o crescimento de projetos de código aberto. Eles permitem que indivíduos com diversas habilidades e antecedentes participem e façam contribuições significativas para o software e a comunidade. +Contribuições no code não envolvem escrever ou modificar o código. Contribuições não codificadas são essenciais para a sustentabilidade e o crescimento de projetos de código aberto. Eles permitem que indivíduos com diversas habilidades e antecedentes participem e façam contribuições significativas para o software e a comunidade. > [Como Contribuir com Código Aberto sem Saber Como Código: um guia com sugestões de projeto](https://dev.to/opensauced/how-to-contribute-to-open-source-without-knowing-how-to-code-a-guide-with-project-suggestions-59e5) @@ -16,7 +16,7 @@ Contribuições não-codificadas não envolvem escrever ou modificar o código. ### Documentação -Você é um amante de palavras? Os erros gramaticais te irritam? Você gosta de resolver problemas complexos ou de ajudar as pessoas a aprender? Então a documentação será para você! +Você é um amante de palavras? Os erros gramaticais irritam-te? Você gosta de resolver problemas complexos ou de ajudar as pessoas a aprender? Então a documentação será para você! Isso envolve criar, melhorar ou manter os recursos escritos que acompanham projetos de software de código aberto. Documentação é crucial para projetos de código aberto. Ele pode tornar um projeto mais acessível e fácil de usar, e pode ajudar a atrair novos contribuidores e incentivar contribuições repetidas. @@ -24,9 +24,9 @@ Isso envolve criar, melhorar ou manter os recursos escritos que acompanham proje _Se você estiver interessado em contribuir com a documentação, aqui estão algumas dicas:_ -- **Leia a documentação**: isso vai te ajudar a entender como o produto é usado. +- **Leia a documentação**: isso vai ajudar-te a entender como o produto é usado. -- **Encontre uma tarefa que seja boa para suas habilidades e interesses**: Se você não tem certeza de por onde começar, dê uma olhada nos problemas ou discussões antes de chegar a um mantenedor. +- **Encontre uma tarefa que seja boa para suas habilidades e interesses**: se você não tem certeza de onde começar, dê uma olhada nos problemas ou discussões antes de chegar a um mantenedor. - **Use o produto**: adquirir informações irá ajudá-lo a ver quais informações são necessárias ou não úteis na documentação. @@ -36,7 +36,6 @@ _Se você estiver interessado em contribuir com a documentação, aqui estão al - Escreva um arquivo README que explique como instalar e usar o projeto: O OpenSauced App - - Crie um tutorial que oriente os usuários através dos recursos do projeto: [Recurso de Destaques OpenSauced](https://docs.opensauced.pizza/community/highlights/) - Atualize a documentação do projeto para refletir as novas alterações: [Adicionar Cartões Dev a Introdução](https://github.com/open-sauced/docs/issues/156) @@ -45,7 +44,6 @@ _Se você estiver interessado em contribuir com a documentação, aqui estão al - Corrigir erros de digitação e gramatical na documentação: Adicionando informações sobre possessives - - Melhore a formatação da documentação: [Destino incorreto do Link na Documentação](https://github.com/open-sauced/docs/pull/144) - Adicione informações faltando à documentação: [Adicionar mais informações para usar esse modelo no README](https\://github.com/open-sauced/100-days -of-oss-template/pull/8) @@ -82,7 +80,7 @@ Esse tipo de contribuição de código aberto envolve a criação e publicação - Escreva sobre o impacto de um projeto de código aberto, como ele tem sido usado para fazer a diferença no mundo: [Manter os melhores engenheiros](https\://opensauced. izza/blog/retaining-the-best-engineers) -- Tipos de Codificação e Não-codificação de Contribuições, como como começar com código aberto: [Código Aberto 101: Um guia para Iniciantes de Começar](https://opensauced.pizza/blog/open-source-101-a-beginner's-guide-to-getting-started) +- Tipos de Codificação e no code de Contribuições, como começar com código aberto: [Código Aberto 101: Um guia para Iniciantes de Começar](https://opensauced.pizza/blog/open-source-101-a-beginner's-guide-to-getting-started) ## Tipo de Não Codificação de Contribuições @@ -94,7 +92,6 @@ Aqui estão alguns exemplos de contribuições que você pode fazer em um projet - **Correções de bugs**: identificar e corrigir bugs é uma contribuição crítica para a codificação. Desenvolvedores localizam problemas na base de código, diagnosticam o problema e depois escrevem o código para corrigi-lo. Correções de bugs melhoram a estabilidade e a confiabilidade do software: Verifique o Lint acontecendo duas vezes no commit - - **Refatoração de Código**: refatoração envolve reestruturação e melhoria do código existente sem mudar seu comportamento externo. Isso ajuda a melhorar a legibilidade de código, manutenção e escalabilidade, que são vitais para a saúde a longo prazo do projeto: [função CalcDistanceFromNow](https://github.com/open-sauced/app/pull/1633) - **Design e Manutenção de API**: Para projetos com API pública, os desenvolvedores podem contribuir para projetar, manter, e melhorar a API para garantir que ela permaneça estável e amigável para o desenvolvedor: [Atualizar token @@ -102,13 +99,8 @@ Aqui estão alguns exemplos de contribuições que você pode fazer em um projet - **Desenvolvimento de recursos**: Os desenvolvedores contribuem implementando novos recursos ou funcionalidades em resposta às necessidades do usuário ou objetivos do projeto. O desenvolvimento de recursos geralmente envolve planejamento, design e codificação de novos componentes ou recursos : Adicionado a página de contato - - **Otimização de desempenho**: Os codificadores podem trabalhar na otimização do desempenho do software refatorando o código, melhorando os algoritmos ou otimizando o uso de recursos. Este tipo de contribuição visa fazer o software funcionar mais eficientemente: [Tabela de repos em telas pequenas não mostra seleto](https://github.com/open-sauced/app/pull/1559) - **Teste e Garantia de Qualidade**: Escrever testes automatizados, incluindo testes de unidade, testes de integração e testes de ponta a ponta, é uma contribuição de codificação que garante confiabilidade do software. Testar ajuda a capturar e prevenir regressões e problemas: [Adicionar componente de login forçado para projetar o sistema](https://github.com/open-sauced/app/pull/1330) -[Próxima Seção ->](08-adicional-resources.md) - - - ✏️ Edite esta página - +[Próxima Seção ->](08-recursos-adicionais.md) From 066d0b693ea6955e51ba5b8d6ac76711ec5eb91d Mon Sep 17 00:00:00 2001 From: Christine Date: Fri, 5 Jan 2024 07:21:12 +0000 Subject: [PATCH 40/62] fix: replace literal translation with English term --- "translations/pt-br/02-o-que-\303\251-open-source.md" | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git "a/translations/pt-br/02-o-que-\303\251-open-source.md" "b/translations/pt-br/02-o-que-\303\251-open-source.md" index 22d2f1d4..de1966ad 100644 --- "a/translations/pt-br/02-o-que-\303\251-open-source.md" +++ "b/translations/pt-br/02-o-que-\303\251-open-source.md" @@ -1,10 +1,10 @@ # O que é Open Source? -Neste capítulo, vamos mergulhar no conceito de código aberto, sua definição e sua história. Obter uma compreensão profunda do código aberto ajudará você a apreciar o contexto em que estará a colaborar e contribuindo. +Neste capítulo, vamos mergulhar no conceito de open source, sua definição e sua história. Obter uma compreensão profunda do open source ajudará você a apreciar o contexto em que estará a colaborar e contribuindo. ## Definição -O termo "código aberto" refere-se a um tipo de software cujo código-fonte é disponibilizado ao público, permitindo que qualquer pessoa visualize, use, modifique e distribua o código. Isso é em contraste com o software proprietário, onde o código-fonte é mantido em segredo e apenas o programa compilado é distribuído. O princípio básico por trás do código aberto é a ideia de colaboração e a crença de que o compartilhamento de conhecimento e recursos leva a um software melhor, mais confiável e mais inovador. +O termo "open source" refere-se a um tipo de software cujo código-fonte é disponibilizado ao público, permitindo que qualquer pessoa visualize, use, modifique e distribua o código. Isso é em contraste com o software proprietário, onde o código-fonte é mantido em segredo e apenas o programa compilado é distribuído. O princípio básico por trás do código aberto é a ideia de colaboração e a crença de que o compartilhamento de conhecimento e recursos leva a um software melhor, mais confiável e mais inovador. Um software de código aberto é construído com base na premissa de que, quando muitas pessoas trabalham juntas, elas podem criar algo maior do que a soma das suas partes. Os contribuidores para projetos de código aberto vêm de origens diversas e trazem uma ampla gama de habilidades, experiências e perspetivas para a mesa. Essa diversidade de pensamento e experiência leva a um software mais robusto, inovador e confiável. From c12475d3055337820caaea5e0c72a1cf31fb204d Mon Sep 17 00:00:00 2001 From: Christine Date: Fri, 5 Jan 2024 07:39:16 +0000 Subject: [PATCH 41/62] fix: translate word blog posts into Portuguese --- translations/pt-br/08-recursos-adicionais.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/translations/pt-br/08-recursos-adicionais.md b/translations/pt-br/08-recursos-adicionais.md index 71098571..c4740605 100644 --- a/translations/pt-br/08-recursos-adicionais.md +++ b/translations/pt-br/08-recursos-adicionais.md @@ -1,4 +1,4 @@ -Felicitações por sua jornada no open source! Aqui estão alguns recursos para aprender mais sobre como começar no open source:source: +Felicitações por sua jornada no open source! Aqui estão alguns recursos para aprender mais sobre como começar no open source: ## Guias e Tutoriais @@ -14,7 +14,7 @@ Felicitações por sua jornada no open source! Aqui estão alguns recursos para - [Open Source Friday](https://opensourcefriday.com/) por GitHub: Um movimento global que incentiva indivíduos e organizações a contribuir para o open source todas as sextas-feiras. O site fornece recursos e guias sobre como começar no open source e encontrar projetos para contribuir. -## Blog posts +## Publicação no blogue - [Além da Criação de Conteúdo: Como as Contribuições de Open Source Podem Ajudá-lo a Ser Notado](https://dev.to/opensauced/beyond-content-creation-how-open-source-contributions-can-help-you-get-noticed-4l5n) From f14ab1120356572f60438df0d81f34652572e827 Mon Sep 17 00:00:00 2001 From: Christine Date: Fri, 5 Jan 2024 07:50:57 +0000 Subject: [PATCH 42/62] fix: revise hyperlink --- "translations/fr/06-la-sauce-secr\303\250te.md" | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git "a/translations/fr/06-la-sauce-secr\303\250te.md" "b/translations/fr/06-la-sauce-secr\303\250te.md" index 9ae35256..17f725ae 100644 --- "a/translations/fr/06-la-sauce-secr\303\250te.md" +++ "b/translations/fr/06-la-sauce-secr\303\250te.md" @@ -74,4 +74,4 @@ En tirant parti d'OpenSauced pour suivre vos contributions open source et dével En conclusion, démarrer avec des contributions open source et avoir un impact durable sur les projets sur lesquels vous travaillez nécessite une combinaison de compétences techniques, de collaboration et de persévérance. En vous concentrant sur les problèmes ouverts, en gagnant du terrain dans vos contributions et en tirant parti d'outils comme OpenSauced, vous serez sur la bonne voie pour un voyage open source réussi et épanouissant. -[Section finale ->](07-conclusion.md) +[Section finale ->](/translations/fr/09-conclusion.md) From 5da4df90420579b2992561bff17877df93c30f17 Mon Sep 17 00:00:00 2001 From: Christine Date: Fri, 5 Jan 2024 07:53:04 +0000 Subject: [PATCH 43/62] fix: corrected hyperlink --- "translations/fr/06-la-sauce-secr\303\250te.md" | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git "a/translations/fr/06-la-sauce-secr\303\250te.md" "b/translations/fr/06-la-sauce-secr\303\250te.md" index 17f725ae..550335f8 100644 --- "a/translations/fr/06-la-sauce-secr\303\250te.md" +++ "b/translations/fr/06-la-sauce-secr\303\250te.md" @@ -74,4 +74,4 @@ En tirant parti d'OpenSauced pour suivre vos contributions open source et dével En conclusion, démarrer avec des contributions open source et avoir un impact durable sur les projets sur lesquels vous travaillez nécessite une combinaison de compétences techniques, de collaboration et de persévérance. En vous concentrant sur les problèmes ouverts, en gagnant du terrain dans vos contributions et en tirant parti d'outils comme OpenSauced, vous serez sur la bonne voie pour un voyage open source réussi et épanouissant. -[Section finale ->](/translations/fr/09-conclusion.md) +[Section finale ->](/translations/fr/07-les-types-de-contributions.md) From 40b46b7af876c08541f720f05646e3d4e11f9baf Mon Sep 17 00:00:00 2001 From: Christine Date: Fri, 5 Jan 2024 07:58:05 +0000 Subject: [PATCH 44/62] fix: change French term --- "translations/fr/06-la-sauce-secr\303\250te.md" | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git "a/translations/fr/06-la-sauce-secr\303\250te.md" "b/translations/fr/06-la-sauce-secr\303\250te.md" index 550335f8..01842d26 100644 --- "a/translations/fr/06-la-sauce-secr\303\250te.md" +++ "b/translations/fr/06-la-sauce-secr\303\250te.md" @@ -74,4 +74,4 @@ En tirant parti d'OpenSauced pour suivre vos contributions open source et dével En conclusion, démarrer avec des contributions open source et avoir un impact durable sur les projets sur lesquels vous travaillez nécessite une combinaison de compétences techniques, de collaboration et de persévérance. En vous concentrant sur les problèmes ouverts, en gagnant du terrain dans vos contributions et en tirant parti d'outils comme OpenSauced, vous serez sur la bonne voie pour un voyage open source réussi et épanouissant. -[Section finale ->](/translations/fr/07-les-types-de-contributions.md) +[Section suivante ->](/translations/fr/07-les-types-de-contributions.md) From 9fa6b60484efe42c9b42cb95b32992289330316e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ant=C3=B3nio=20Pedro?= <42675180+antonio-pedro99@users.noreply.github.com> Date: Sat, 6 Jan 2024 19:30:18 +0530 Subject: [PATCH 45/62] Update translations/pt-br/05-como-contribuir-para-open-source.md --- translations/pt-br/05-como-contribuir-para-open-source.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/translations/pt-br/05-como-contribuir-para-open-source.md b/translations/pt-br/05-como-contribuir-para-open-source.md index 00ed8986..d5cb5a31 100644 --- a/translations/pt-br/05-como-contribuir-para-open-source.md +++ b/translations/pt-br/05-como-contribuir-para-open-source.md @@ -45,4 +45,4 @@ OpenSauced é uma ferramenta poderosa para encontrar projetos de open source par Ao usar o OpenSauced, você pode agilizar o processo de localização de projetos de open source para trabalhar e focar na contribuição para os projetos que se alinham aos seus interesses e objetivos. -[Próximo Capítulo ->](/translations/pt-br/06-o-segredo-do%20sauce.md) \ No newline at end of file +[Próximo Capítulo ->](/translations/pt-br/06-o-segredo-do-sauce.md) \ No newline at end of file From f7d1d20b4d5edbdd9c763c14cc350ef7dde7505f Mon Sep 17 00:00:00 2001 From: Antonio Pedro Date: Sat, 6 Jan 2024 20:04:39 +0530 Subject: [PATCH 46/62] fix some links and edit page Signed-off-by: Antonio Pedro --- "translations/pt-br/01-introdu\303\247\303\243o.md" | 6 +++++- "translations/pt-br/02-o-que-\303\251-open-source.md" | 6 +++++- translations/pt-br/03-por-que-open-source.md | 6 +++++- translations/pt-br/04-ferramentas-utilizadas.md | 6 +++++- .../pt-br/05-como-contribuir-para-open-source.md | 6 +++++- translations/pt-br/06-o-segredo-do-sauce.md | 6 +++++- .../07-tipos-de-contribuic\314\247o\314\203es.md" | 11 +++++++---- translations/pt-br/08-recursos-adicionais.md | 8 +++++++- "translations/pt-br/09-conclus\303\243o.md" | 8 +++++++- "translations/pt-br/10-gloss\303\241rio.md" | 6 +++++- 10 files changed, 56 insertions(+), 13 deletions(-) diff --git "a/translations/pt-br/01-introdu\303\247\303\243o.md" "b/translations/pt-br/01-introdu\303\247\303\243o.md" index b53d3522..6e49d0a8 100644 --- "a/translations/pt-br/01-introdu\303\247\303\243o.md" +++ "b/translations/pt-br/01-introdu\303\247\303\243o.md" @@ -64,4 +64,8 @@ Usar os exemplos e demos como ponto de partida, mas não tenha medo de explorar Agora que nos apresentamos, é hora de embarcar em sua jornada de open source! No próximo capítulo, mergulharemos na definição de open source e exploraremos sua história, preparando o cenário para uma compreensão mais profunda da colaboração de open source. Vamos começar! -[Próximo Capítulo ->](/translations/pt-br/02-o-que-é-open-source.md) \ No newline at end of file +[Próximo Capítulo ->](/translations/pt-br/02-o-que-é-open-source.md) + + +✏️ Editar esta página + diff --git "a/translations/pt-br/02-o-que-\303\251-open-source.md" "b/translations/pt-br/02-o-que-\303\251-open-source.md" index de1966ad..2f2e6591 100644 --- "a/translations/pt-br/02-o-que-\303\251-open-source.md" +++ "b/translations/pt-br/02-o-que-\303\251-open-source.md" @@ -66,4 +66,8 @@ O crescente interesse e adoção do código aberto também levaram a ecossistema No próximo capítulo, exploraremos os muitos benefícios de contribuir para projetos de código aberto e discutiremos como a colaboração de código aberto pode ajudá-lo a acessar conhecimento, se conectar com uma comunidade e desenvolver habilidades valiosas. -[Próximo Capítulo ->](/translations/pt-br/03-por-que-open-source.md) \ No newline at end of file +[Próximo Capítulo ->](/translations/pt-br/03-por-que-open-source.md) + + +✏️ Editar esta página + \ No newline at end of file diff --git a/translations/pt-br/03-por-que-open-source.md b/translations/pt-br/03-por-que-open-source.md index a7aaf4ca..e3245bed 100644 --- a/translations/pt-br/03-por-que-open-source.md +++ b/translations/pt-br/03-por-que-open-source.md @@ -54,4 +54,8 @@ Além dos benefícios mencionados acima, contribuir para projetos de código abe No próximo capítulo, discutiremos as ferramentas e recursos essenciais de que você precisará para ter sucesso em sua jornada de código aberto, incluindo GitHub, Git, CodeSee, VS Code e Discord. Ao se familiarizar com essas ferramentas, você estará melhor equipado para colaborar com outras pessoas, gerenciar seus projetos e contribuir efetivamente para projetos de código aberto. -[Próximo Capítulo -->](/translations/pt-br/04-ferramentas-utilizadas.md) \ No newline at end of file +[Próximo Capítulo -->](/translations/pt-br/04-ferramentas-utilizadas.md) + + +✏️ Editar esta página + \ No newline at end of file diff --git a/translations/pt-br/04-ferramentas-utilizadas.md b/translations/pt-br/04-ferramentas-utilizadas.md index 71238aab..0410bce8 100644 --- a/translations/pt-br/04-ferramentas-utilizadas.md +++ b/translations/pt-br/04-ferramentas-utilizadas.md @@ -135,4 +135,8 @@ Para começar com o Discord, visite o site oficial (https://discord.com/) e insc Familiarizando-se com essas ferramentas e plataformas, você estará equipado para colaborar efetivamente, gerir os seus projetos e contribuir para projetos de código aberto. No próximo capítulo, discutiremos como contribuir para projetos de código aberto, incluindo encontrar projetos para trabalhar, enviar contribuições e o que acontece depois que a sua contribuição é aceite. -[Próximo Capítulo ->](/translations/pt-br/05-como-contribuir-para-open-source.md) \ No newline at end of file +[Próximo Capítulo ->](/translations/pt-br/05-como-contribuir-para-open-source.md) + + +✏️ Editar esta página + \ No newline at end of file diff --git a/translations/pt-br/05-como-contribuir-para-open-source.md b/translations/pt-br/05-como-contribuir-para-open-source.md index d5cb5a31..97bd17d2 100644 --- a/translations/pt-br/05-como-contribuir-para-open-source.md +++ b/translations/pt-br/05-como-contribuir-para-open-source.md @@ -45,4 +45,8 @@ OpenSauced é uma ferramenta poderosa para encontrar projetos de open source par Ao usar o OpenSauced, você pode agilizar o processo de localização de projetos de open source para trabalhar e focar na contribuição para os projetos que se alinham aos seus interesses e objetivos. -[Próximo Capítulo ->](/translations/pt-br/06-o-segredo-do-sauce.md) \ No newline at end of file +[Próximo Capítulo ->](/translations/pt-br/06-o-segredo-do-sauce.md) + + +✏️ Editar esta página + \ No newline at end of file diff --git a/translations/pt-br/06-o-segredo-do-sauce.md b/translations/pt-br/06-o-segredo-do-sauce.md index f2c00949..0e64c760 100644 --- a/translations/pt-br/06-o-segredo-do-sauce.md +++ b/translations/pt-br/06-o-segredo-do-sauce.md @@ -75,4 +75,8 @@ Ao alavancar o OpenSauced para rastrear suas contribuições de código aberto e Para concluir, começar a contribuir para o código aberto e causar um impacto duradouro nos projetos em que você trabalha requer uma combinação de habilidades técnicas, colaboração e persistência. Ao se concentrar em issues abertas, ganhar tração em suas contribuições e alavancar ferramentas como OpenSauced, você estará bem encaminhado para uma jornada de código aberto bem-sucedida e gratificante. -[Último Capítulo ->](/translations/pt-br/07-conclusão.md) +[Último Capítulo ->](/translations/pt-br/07-tipos-de-contribuições.md) + + +✏️ Editar esta página + diff --git "a/translations/pt-br/07-tipos-de-contribuic\314\247o\314\203es.md" "b/translations/pt-br/07-tipos-de-contribuic\314\247o\314\203es.md" index 6f5fc05f..cf473fe5 100644 --- "a/translations/pt-br/07-tipos-de-contribuic\314\247o\314\203es.md" +++ "b/translations/pt-br/07-tipos-de-contribuic\314\247o\314\203es.md" @@ -94,13 +94,16 @@ Aqui estão alguns exemplos de contribuições que você pode fazer em um projet - **Refatoração de Código**: refatoração envolve reestruturação e melhoria do código existente sem mudar seu comportamento externo. Isso ajuda a melhorar a legibilidade de código, manutenção e escalabilidade, que são vitais para a saúde a longo prazo do projeto: [função CalcDistanceFromNow](https://github.com/open-sauced/app/pull/1633) -- **Design e Manutenção de API**: Para projetos com API pública, os desenvolvedores podem contribuir para projetar, manter, e melhorar a API para garantir que ela permaneça estável e amigável para o desenvolvedor: [Atualizar token - ](https\://github. Um/IridiumIdentidade/iridium/pull/134) +- **Design e Manutenção de API**: Para projetos com API pública, os desenvolvedores podem contribuir para projetar, manter, e melhorar a API para garantir que ela permaneça estável e amigável para o desenvolvedor: [Atualizar token](https://github.com/IridiumIdentidade/iridium/pull/134) -- **Desenvolvimento de recursos**: Os desenvolvedores contribuem implementando novos recursos ou funcionalidades em resposta às necessidades do usuário ou objetivos do projeto. O desenvolvimento de recursos geralmente envolve planejamento, design e codificação de novos componentes ou recursos : Adicionado a página de contato +- **Desenvolvimento de recursos**: Os desenvolvedores contribuem implementando novos recursos ou funcionalidades em resposta às necessidades do usuário, ou objetivos do projeto. O desenvolvimento de recursos geralmente envolve planejamento, design e codificação de novos componentes ou recursos : Adicionado a página de contato - **Otimização de desempenho**: Os codificadores podem trabalhar na otimização do desempenho do software refatorando o código, melhorando os algoritmos ou otimizando o uso de recursos. Este tipo de contribuição visa fazer o software funcionar mais eficientemente: [Tabela de repos em telas pequenas não mostra seleto](https://github.com/open-sauced/app/pull/1559) - **Teste e Garantia de Qualidade**: Escrever testes automatizados, incluindo testes de unidade, testes de integração e testes de ponta a ponta, é uma contribuição de codificação que garante confiabilidade do software. Testar ajuda a capturar e prevenir regressões e problemas: [Adicionar componente de login forçado para projetar o sistema](https://github.com/open-sauced/app/pull/1330) -[Próxima Seção ->](08-recursos-adicionais.md) +[Próxima Seção ->](/translations/pt-br/08-recursos-adicionais.md) + + +✏️ Editar esta página + \ No newline at end of file diff --git a/translations/pt-br/08-recursos-adicionais.md b/translations/pt-br/08-recursos-adicionais.md index c4740605..d20e94fb 100644 --- a/translations/pt-br/08-recursos-adicionais.md +++ b/translations/pt-br/08-recursos-adicionais.md @@ -22,4 +22,10 @@ Felicitações por sua jornada no open source! Aqui estão alguns recursos para - [Como Contribuir para Open Source sem Saber Programar: Um guia com sugestões de projetos](https://dev.to/opensauced/how-to-contribute-to-open-source-without-knowing-how-to-code-a-guide-with-project-suggestions-59e5) -- [Como Escrever uma Boa Issue: Dicas para Comunicação Eficaz em Open Source](https://dev.to/opensauced/how-to-write-a-good-issue-tips-for-effective-communication-in-open-source-5443) \ No newline at end of file +- [Como Escrever uma Boa Issue: Dicas para Comunicação Eficaz em Open Source](https://dev.to/opensauced/how-to-write-a-good-issue-tips-for-effective-communication-in-open-source-5443) + +[Próximo Capítulo ->](/translations/pt-br/09-conclusão.md) + + +✏️ Editar esta página + \ No newline at end of file diff --git "a/translations/pt-br/09-conclus\303\243o.md" "b/translations/pt-br/09-conclus\303\243o.md" index 62cbe830..f9167439 100644 --- "a/translations/pt-br/09-conclus\303\243o.md" +++ "b/translations/pt-br/09-conclus\303\243o.md" @@ -36,4 +36,10 @@ Com o conhecimento e as ferramentas que você adquiriu neste curso, você está 7. **Continue aprendendo**: O open source é um campo dinâmico e em constante evolução. Mantenha-se atualizado com as últimas ferramentas, técnicas e melhores práticas participando de workshops, fazendo cursos on-line e lendo artigos e livros sobre desenvolvimento de open source. Incluímos uma [seção de recursos adicionais](/translations/pt-br/08-recursos-adicionais.md) para obter mais informações. -Em conclusão, embarcar em uma jornada de open source é uma experiência gratificante e enriquecedora que pode ajudá-lo a desenvolver novas habilidades, se conectar com pessoas de mentalidade semelhante e ter um impacto duradouro nos projetos em que trabalha. Com o conhecimento e as ferramentas que você adquiriu neste curso, você está bem preparado para enfrentar os desafios e oportunidades emocionantes que o aguardam no mundo do open source. Então vá em frente e comece a contribuir - a comunidade de open source aguarda ansiosamente sua participação! \ No newline at end of file +Em conclusão, embarcar em uma jornada de open source é uma experiência gratificante e enriquecedora que pode ajudá-lo a desenvolver novas habilidades, se conectar com pessoas de mentalidade semelhante e ter um impacto duradouro nos projetos em que trabalha. Com o conhecimento e as ferramentas que você adquiriu neste curso, você está bem preparado para enfrentar os desafios e oportunidades emocionantes que o aguardam no mundo do open source. Então vá em frente e comece a contribuir - a comunidade de open source aguarda ansiosamente sua participação! + +[Próximo Capítulo ->](/translations/pt-br/10-glossário.md) + + +✏️ Editar esta página + \ No newline at end of file diff --git "a/translations/pt-br/10-gloss\303\241rio.md" "b/translations/pt-br/10-gloss\303\241rio.md" index a4dc7c7c..15ac471d 100644 --- "a/translations/pt-br/10-gloss\303\241rio.md" +++ "b/translations/pt-br/10-gloss\303\241rio.md" @@ -42,4 +42,8 @@ Merge é o processo de combinar alterações de uma ramificação em outra. Quan Isso é uma abreviação da palavra "documentação", um pedaço de texto que fornece informações sobre como contribuir para projetos de código aberto e expectativas para os contribuidores. O Markdown, uma linguagem de codificação baseada em texto, é frequentemente usado para criar esse tipo de conteúdo. -Quer ver um exemplo em ação? Confira o [Guia de Estilo no nosso repositório Pizza Verse](https://github.com/open-sauced/pizza-verse/blob/main/style-guide.md)! \ No newline at end of file +Quer ver um exemplo em ação? Confira o [Guia de Estilo no nosso repositório Pizza Verse](https://github.com/open-sauced/pizza-verse/blob/main/style-guide.md)! + + +✏️ Editar esta página + \ No newline at end of file From ef028745dd41b98e5a24e1ce3a7a76504ce4af30 Mon Sep 17 00:00:00 2001 From: Christine Belzie <105683440+CBID2@users.noreply.github.com> Date: Wed, 10 Jan 2024 22:24:19 -0500 Subject: [PATCH 47/62] fix: revise translation Co-authored-by: Vitor Ayres --- "translations/pt-br/01-introdu\303\247\303\243o.md" | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git "a/translations/pt-br/01-introdu\303\247\303\243o.md" "b/translations/pt-br/01-introdu\303\247\303\243o.md" index 6e49d0a8..3c3868a1 100644 --- "a/translations/pt-br/01-introdu\303\247\303\243o.md" +++ "b/translations/pt-br/01-introdu\303\247\303\243o.md" @@ -8,7 +8,7 @@ Mas primeiro, vamos preparar o cenário discutindo os pré-requisitos, objetivos ## Pré-requisitos Antes de mergulhar no mundo do open source, é essencial ter uma compreensão básica dos conceitos de programação e alguma experiência trabalhando com código. -Embora o curso forneça exemplos e demonstrações, você obterá o máximo do material se tiver algum conhecimento prévio. +Embora o curso forneça exemplos e demonstrações, você aproveitará o máximo do conteúdo se tiver algum conhecimento prévio. Além disso, este curso pressupõe que você esteja familiarizado com o Git e o GitHub. O Git é um sistema de controle de versão amplamente utilizado, e o GitHub é uma plataforma popular para hospedar e colaborar em repositórios Git. From 0e93209bc5cfbe147e408ff04ae4af37d495bbc2 Mon Sep 17 00:00:00 2001 From: Christine Belzie <105683440+CBID2@users.noreply.github.com> Date: Wed, 10 Jan 2024 22:45:06 -0500 Subject: [PATCH 48/62] fix: revise translation Co-authored-by: Vitor Ayres --- "translations/pt-br/01-introdu\303\247\303\243o.md" | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git "a/translations/pt-br/01-introdu\303\247\303\243o.md" "b/translations/pt-br/01-introdu\303\247\303\243o.md" index 3c3868a1..6f295397 100644 --- "a/translations/pt-br/01-introdu\303\247\303\243o.md" +++ "b/translations/pt-br/01-introdu\303\247\303\243o.md" @@ -54,7 +54,7 @@ Este curso é dividido em vários capítulos, cada um projetado para cobrir um a 6. **O segredo do sauce:** Este capítulo revelará as estratégias e técnicas para começar, ganhar tração em suas contribuições, 7. **Conclusão:** Encerraremos o curso com as principais conclusões e discutiremos os próximos passos em sua jornada de open source. -Ao longo deste curso, forneceremos exemplos e demonstrações para ajudar a ilustrar conceitos-chave e fornecer oportunidades práticas de prática. Quando possível, apresentaremos projetos e ferramentas de open source do mundo real, como [OpenSauced](https://opensauced.pizza/), para demonstrar como aplicar as habilidades que você aprendeu. +Ao longo deste curso, forneceremos exemplos e demonstrações para ajudar a ilustrar conceitos-chave e fornecer exercícios práticos. Quando possível, apresentaremos projetos e ferramentas de open source do mundo real, como [OpenSauced](https://opensauced.pizza/), para demonstrar como aplicar as habilidades que você aprendeu. Por favor, note que enquanto esses exemplos e demonstrações são projetados para fornecer orientação e inspiração, sua própria jornada de open source pode ser diferente, dependendo de seus interesses, habilidades e projetos escolhidos. From 7c9aa16fee615f18144a67c8d91e1c561284dc88 Mon Sep 17 00:00:00 2001 From: Christine Belzie <105683440+CBID2@users.noreply.github.com> Date: Wed, 10 Jan 2024 22:46:05 -0500 Subject: [PATCH 49/62] fix: revise wording Co-authored-by: Vitor Ayres --- translations/pt-br/03-por-que-open-source.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/translations/pt-br/03-por-que-open-source.md b/translations/pt-br/03-por-que-open-source.md index e3245bed..7024a3c8 100644 --- a/translations/pt-br/03-por-que-open-source.md +++ b/translations/pt-br/03-por-que-open-source.md @@ -40,7 +40,7 @@ Contribuir para projetos de código aberto pode ajudá-lo a desenvolver uma ampl 5. **Aprenda gerenciamento e organização de projetos**: contribuir para projetos de código aberto pode expô-lo a vários aspetos do gerenciamento e organização de projetos, como planejamento, documentação e controle de versão. Ao aprender a gerenciar projetos de código aberto, você pode desenvolver habilidades que podem ser aplicadas a projetos pessoais e profissionais. -6. **Desenvolva habilidades de liderança e mentoria**: ao ganhar experiência na comunidade de código aberto, você pode se encontrar numa posição para orientar e orientar novos contribuidores. Ao assumir esses papéis de liderança, você pode desenvolver habilidades essenciais, como comunicação, empatia e delegação, que podem ajudá-lo a ter sucesso em sua carreira e vida pessoal. +6. **Desenvolva habilidades de liderança e mentoria**: ao ganhar experiência na comunidade de código aberto, você pode se encontrar numa posição para orientar e guiar novos contribuidores. Ao assumir esses papéis de liderança, você pode desenvolver habilidades essenciais, como comunicação, empatia e delegação, que podem ajudá-lo a ter sucesso em sua carreira e vida pessoal. ## Benefícios adicionais From 3b774663f11b800748109e20bdc1fd9ea0954779 Mon Sep 17 00:00:00 2001 From: Christine Belzie <105683440+CBID2@users.noreply.github.com> Date: Wed, 10 Jan 2024 22:46:51 -0500 Subject: [PATCH 50/62] fix: use Brazilian-PR term Co-authored-by: Vitor Ayres --- translations/pt-br/03-por-que-open-source.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/translations/pt-br/03-por-que-open-source.md b/translations/pt-br/03-por-que-open-source.md index 7024a3c8..9030608c 100644 --- a/translations/pt-br/03-por-que-open-source.md +++ b/translations/pt-br/03-por-que-open-source.md @@ -38,7 +38,7 @@ Contribuir para projetos de código aberto pode ajudá-lo a desenvolver uma ampl 4. **Desenvolva habilidades de resolução de problemas e pensamento crítico**: trabalhar em projetos de código aberto geralmente envolve enfrentar problemas complexos e tomar decisões importantes. Ao navegar nesses desafios, você pode desenvolver habilidades valiosas de resolução de problemas e pensamento crítico que podem ser aplicadas a vários aspectos de sua vida e carreira. -5. **Aprenda gerenciamento e organização de projetos**: contribuir para projetos de código aberto pode expô-lo a vários aspetos do gerenciamento e organização de projetos, como planejamento, documentação e controle de versão. Ao aprender a gerenciar projetos de código aberto, você pode desenvolver habilidades que podem ser aplicadas a projetos pessoais e profissionais. +5. **Aprenda gerenciamento e organização de projetos**: contribuir para projetos de código aberto pode expô-lo a vários aspectos do gerenciamento e organização de projetos, como planejamento, documentação e controle de versão. Ao aprender a gerenciar projetos de código aberto, você pode desenvolver habilidades que podem ser aplicadas a projetos pessoais e profissionais. 6. **Desenvolva habilidades de liderança e mentoria**: ao ganhar experiência na comunidade de código aberto, você pode se encontrar numa posição para orientar e guiar novos contribuidores. Ao assumir esses papéis de liderança, você pode desenvolver habilidades essenciais, como comunicação, empatia e delegação, que podem ajudá-lo a ter sucesso em sua carreira e vida pessoal. From 19bc12c6bd38ffcc5f77af4177d8f3d579f9f6e0 Mon Sep 17 00:00:00 2001 From: Christine Belzie <105683440+CBID2@users.noreply.github.com> Date: Wed, 10 Jan 2024 22:47:45 -0500 Subject: [PATCH 51/62] fix: revise translation Co-authored-by: Vitor Ayres --- "translations/pt-br/02-o-que-\303\251-open-source.md" | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git "a/translations/pt-br/02-o-que-\303\251-open-source.md" "b/translations/pt-br/02-o-que-\303\251-open-source.md" index 2f2e6591..55627fcf 100644 --- "a/translations/pt-br/02-o-que-\303\251-open-source.md" +++ "b/translations/pt-br/02-o-que-\303\251-open-source.md" @@ -28,7 +28,7 @@ No entanto, na década de 1970, à medida que a indústria de software começou Como consequência da crescente restrição ao acesso ao código-fonte, o programador Richard Stallman fundou a Free Software Foundation (FSF) em 1985. O objetivo da FSF era promover o desenvolvimento e o uso de software livre, que eles definiram como software que concede aos usuários a liberdade de executar, estudar, compartilhar e modificar o código. Esse conceito é semelhante ao código aberto, mas enfatiza mais os aspectos éticos e políticos da liberdade de software. -Stallman e a FSF passaram a desenvolver o Projeto GNU (que significa "GNU's Not Unix"), um esforço ambicioso para criar um sistema operativo completamente livre e aberto. Embora o Projeto GNU tenha fornecido muitos componentes essenciais, faltava uma peça crítica: um kernel livre e aberto, o componente central de um sistema operativo. +Stallman e a FSF passaram a desenvolver o Projeto GNU (que significa "GNU's Not Unix"), um esforço ambicioso para criar um sistema operacional completamente livre e aberto. Embora o Projeto GNU tenha fornecido muitos componentes essenciais, faltava uma peça crítica: um kernel livre e aberto, o componente central de um sistema operacional. ### O surgimento do Linux From 6009f7f4db6da0864d581a794e6347c64fb20e54 Mon Sep 17 00:00:00 2001 From: Christine Belzie <105683440+CBID2@users.noreply.github.com> Date: Wed, 10 Jan 2024 22:48:31 -0500 Subject: [PATCH 52/62] fix: revise terms Co-authored-by: Vitor Ayres --- translations/pt-br/03-por-que-open-source.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/translations/pt-br/03-por-que-open-source.md b/translations/pt-br/03-por-que-open-source.md index 9030608c..2a1986f4 100644 --- a/translations/pt-br/03-por-que-open-source.md +++ b/translations/pt-br/03-por-que-open-source.md @@ -8,7 +8,7 @@ Um dos principais benefícios de contribuir para projetos de código aberto é a 1. **Aprenda com projetos reais**: Projetos de código aberto oferecem uma oportunidade única de estudar e aprender com bases de código do mundo real. Ao examinar como outros desenvolvedores enfrentaram problemas complexos, você pode obter insights sobre as melhores práticas, padrões de design e técnicas de ponta que pode aplicar aos seus próprios projetos. -2. **Acesse perspetivas diversas**: Projetos de código aberto atraem contribuidores de todo o mundo, cada um trazendo seu próprio conjunto único de habilidades, experiências e perspectivas. Ao colaborar com outras pessoas, você pode ampliar sua compreensão de diferentes tecnologias, linguagens de programação e metodologias de desenvolvimento. +2. **Acesse diversas perspectivas**: Projetos de código aberto atraem contribuidores de todo o mundo, cada um trazendo seu próprio conjunto único de habilidades, experiências e perspectivas. Ao colaborar com outras pessoas, você pode ampliar sua compreensão de diferentes tecnologias, linguagens de programação e metodologias de desenvolvimento. 3. **Mantenha-se atualizado com as últimas tendências**: A comunidade de código aberto geralmente está na vanguarda da inovação, com novos projetos, ferramentas e tecnologias constantemente surgindo. Ao participar de projetos de código aberto, você pode se manter atualizado com os últimos desenvolvimentos em sua área e aprender sobre tendências emergentes e melhores práticas. From 386086c10e30e860ccb2a4a81749a6df9546f417 Mon Sep 17 00:00:00 2001 From: Christine Belzie <105683440+CBID2@users.noreply.github.com> Date: Wed, 10 Jan 2024 22:49:02 -0500 Subject: [PATCH 53/62] fix: revise translation Co-authored-by: Vitor Ayres --- translations/pt-br/03-por-que-open-source.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/translations/pt-br/03-por-que-open-source.md b/translations/pt-br/03-por-que-open-source.md index 2a1986f4..6b47488a 100644 --- a/translations/pt-br/03-por-que-open-source.md +++ b/translations/pt-br/03-por-que-open-source.md @@ -22,7 +22,7 @@ A comunidade de código aberto é uma rede diversificada e global de desenvolved 2. **Expanda a sua rede**: A comunidade de código aberto é vasta e interconectada, com inúmeros projetos, eventos e fóruns onde os desenvolvedores se reúnem para colaborar e compartilhar conhecimento. Ao participar dessas atividades, você pode expandir sua rede profissional e se conectar com potenciais mentores, colaboradores e até empregadores. -3. **Desenvolva habilidades de comunicação e colaboração**: trabalhar em projetos de código aberto geralmente envolve colaborar com outras pessoas, remota ou pessoalmente. Isso pode ajudá-lo a desenvolver habilidades essenciais de comunicação e colaboração, como fornecer feedback construtivo, resolver conflitos e trabalhar efetivamente em equipe. +3. **Desenvolva habilidades de comunicação e colaboração**: trabalhar em projetos de código aberto geralmente envolve colaborar com outras pessoas, remotamente ou pessoalmente. Isso pode ajudá-lo a desenvolver habilidades essenciais de comunicação e colaboração, como fornecer feedback construtivo, resolver conflitos e trabalhar efetivamente em equipe. 4. **Retribua à comunidade**: Contribuir para projetos de código aberto é uma maneira de retribuir à comunidade que lhe forneceu conhecimento e recursos valiosos. Compartilhando as suas habilidades e experiência, você pode ajudar a apoiar o crescimento e o sucesso contínuo do movimento de código aberto. From 93d8fa2c645881d4482db15dfc40fb0cde9d2c66 Mon Sep 17 00:00:00 2001 From: Christine Belzie <105683440+CBID2@users.noreply.github.com> Date: Wed, 10 Jan 2024 22:49:32 -0500 Subject: [PATCH 54/62] fix: revise translation Co-authored-by: Vitor Ayres --- "translations/pt-br/02-o-que-\303\251-open-source.md" | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git "a/translations/pt-br/02-o-que-\303\251-open-source.md" "b/translations/pt-br/02-o-que-\303\251-open-source.md" index 55627fcf..3f1f64f6 100644 --- "a/translations/pt-br/02-o-que-\303\251-open-source.md" +++ "b/translations/pt-br/02-o-que-\303\251-open-source.md" @@ -62,7 +62,7 @@ O movimento de código aberto percorreu um longo caminho desde os seus primórdi À medida que o código aberto continua a evoluir, novos projetos, ferramentas e tecnologias estão constantemente surgindo, empurrando os limites do que é possível e impulsionando a inovação em uma ampla gama de indústrias. -O crescente interesse e adoção do código aberto também levaram a ecossistema de código aberto próspero de conferências, meetups e comunidades online onde os desenvolvedores podem se reunir para aprender, colaborar e compartilhar os seus conhecimentos. Ao participar desses eventos e se envolver com a comunidade de código aberto, você terá a oportunidade de expandir as suas habilidades, construir a sua rede e se manter atualizado com os últimos desenvolvimentos na �rea. +O crescente interesse e adoção do código aberto também levaram a um ecossistema de código aberto próspero de conferências, meetups e comunidades online onde os desenvolvedores podem se reunir para aprender, colaborar e compartilhar os seus conhecimentos. Ao participar desses eventos e se envolver com a comunidade de código aberto, você terá a oportunidade de expandir as suas habilidades, construir a sua rede e se manter atualizado com os últimos desenvolvimentos na área. No próximo capítulo, exploraremos os muitos benefícios de contribuir para projetos de código aberto e discutiremos como a colaboração de código aberto pode ajudá-lo a acessar conhecimento, se conectar com uma comunidade e desenvolver habilidades valiosas. From 98735843b96b0d7accde75de68fb900c0489da49 Mon Sep 17 00:00:00 2001 From: Christine Belzie <105683440+CBID2@users.noreply.github.com> Date: Wed, 10 Jan 2024 22:50:05 -0500 Subject: [PATCH 55/62] fix: revise translation Co-authored-by: Vitor Ayres --- "translations/pt-br/02-o-que-\303\251-open-source.md" | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git "a/translations/pt-br/02-o-que-\303\251-open-source.md" "b/translations/pt-br/02-o-que-\303\251-open-source.md" index 3f1f64f6..956313b2 100644 --- "a/translations/pt-br/02-o-que-\303\251-open-source.md" +++ "b/translations/pt-br/02-o-que-\303\251-open-source.md" @@ -6,7 +6,7 @@ Neste capítulo, vamos mergulhar no conceito de open source, sua definição e s O termo "open source" refere-se a um tipo de software cujo código-fonte é disponibilizado ao público, permitindo que qualquer pessoa visualize, use, modifique e distribua o código. Isso é em contraste com o software proprietário, onde o código-fonte é mantido em segredo e apenas o programa compilado é distribuído. O princípio básico por trás do código aberto é a ideia de colaboração e a crença de que o compartilhamento de conhecimento e recursos leva a um software melhor, mais confiável e mais inovador. -Um software de código aberto é construído com base na premissa de que, quando muitas pessoas trabalham juntas, elas podem criar algo maior do que a soma das suas partes. Os contribuidores para projetos de código aberto vêm de origens diversas e trazem uma ampla gama de habilidades, experiências e perspetivas para a mesa. Essa diversidade de pensamento e experiência leva a um software mais robusto, inovador e confiável. +Um software de código aberto é construído com base na premissa de que, quando muitas pessoas trabalham juntas, elas podem criar algo maior do que a soma das suas partes. Os contribuidores para projetos de código aberto vêm de origens diversas e trazem uma ampla gama de habilidades, experiências e perspectivas para a mesa. Essa diversidade de pensamento e experiência leva a um software mais robusto, inovador e confiável. ### Licenças de código aberto From 0b15f132b50235e51df3625c940e5a75a603e73a Mon Sep 17 00:00:00 2001 From: Christine Belzie <105683440+CBID2@users.noreply.github.com> Date: Sat, 17 Feb 2024 15:27:31 -0500 Subject: [PATCH 56/62] fix: translate into Portuguese Co-authored-by: Vitor Ayres --- translations/pt-br/04-ferramentas-utilizadas.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/translations/pt-br/04-ferramentas-utilizadas.md b/translations/pt-br/04-ferramentas-utilizadas.md index 0410bce8..af3e18f6 100644 --- a/translations/pt-br/04-ferramentas-utilizadas.md +++ b/translations/pt-br/04-ferramentas-utilizadas.md @@ -118,7 +118,7 @@ Visual Studio Code (VS Code) é um editor de código popular, gratuito e de cód - **Suporte Git integrado**: O VS Code oferece suporte integrado para Git, permitindo que você gerencie os seus repositórios Git, estágio e confirme alterações e resolva conflitos de mesclagem diretamente do editor. - **Extensibilidade**: O VS Code oferece um rico ecossistema de extensões que podem aprimorar a sua experiência de desenvolvimento e adicionar suporte para idiomas, ferramentas e estruturas adicionais. - **Terminal integrado**: O VS Code inclui um terminal integrado que permite executar comandos, scripts e tarefas de compilação diretamente do editor. -- **Customizável**: O VS Code é altamente customizável, permitindo que você adapte o editor às suas preferências e fluxo de trabalho. Você pode personalizar o tema, keybindings e configurações para criar um ambiente de desenvolvimento personalizado. +- **Customizável**: O VS Code é altamente customizável, permitindo que você adapte o editor às suas preferências e fluxo de trabalho. Você pode personalizar o tema, atalhos de teclado e configurações para criar um ambiente de desenvolvimento personalizado. Para baixar e instalar o VS Code, visite o site oficial (https://code.visualstudio.com/) e siga as instruções para o seu sistema operativo. From 0f68d09ba7c4a6f20ac1cf7e6e213f79853c8e42 Mon Sep 17 00:00:00 2001 From: Christine Belzie <105683440+CBID2@users.noreply.github.com> Date: Sat, 17 Feb 2024 15:28:06 -0500 Subject: [PATCH 57/62] fix: translate into Portuguese Co-authored-by: Vitor Ayres --- translations/pt-br/04-ferramentas-utilizadas.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/translations/pt-br/04-ferramentas-utilizadas.md b/translations/pt-br/04-ferramentas-utilizadas.md index af3e18f6..a355bb62 100644 --- a/translations/pt-br/04-ferramentas-utilizadas.md +++ b/translations/pt-br/04-ferramentas-utilizadas.md @@ -120,7 +120,7 @@ Visual Studio Code (VS Code) é um editor de código popular, gratuito e de cód - **Terminal integrado**: O VS Code inclui um terminal integrado que permite executar comandos, scripts e tarefas de compilação diretamente do editor. - **Customizável**: O VS Code é altamente customizável, permitindo que você adapte o editor às suas preferências e fluxo de trabalho. Você pode personalizar o tema, atalhos de teclado e configurações para criar um ambiente de desenvolvimento personalizado. -Para baixar e instalar o VS Code, visite o site oficial (https://code.visualstudio.com/) e siga as instruções para o seu sistema operativo. +Para baixar e instalar o VS Code, visite o site oficial (https://code.visualstudio.com/) e siga as instruções para o seu sistema operacional. ## Discord From 5e66e79d2dae2ba46221d9c1e22119ccb7cca1ab Mon Sep 17 00:00:00 2001 From: Christine Belzie <105683440+CBID2@users.noreply.github.com> Date: Sat, 17 Feb 2024 15:28:56 -0500 Subject: [PATCH 58/62] fix: revise typo Co-authored-by: Vitor Ayres --- translations/pt-br/04-ferramentas-utilizadas.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/translations/pt-br/04-ferramentas-utilizadas.md b/translations/pt-br/04-ferramentas-utilizadas.md index a355bb62..d1ec1548 100644 --- a/translations/pt-br/04-ferramentas-utilizadas.md +++ b/translations/pt-br/04-ferramentas-utilizadas.md @@ -109,7 +109,7 @@ CodeSee é uma poderosa ferramenta de visualização que ajuda os desenvolvedore - **Analisar a estrutura do código**: O CodeSee permite que você visualize a estrutura do seu código, facilitando identificar padrões, antipadrões e áreas para melhorias. - **Navegar em grandes bases de código**: com o CodeSee, você pode navegar rapidamente em grandes bases de código e encontrar as partes do código que você precisa trabalhar. -Para começar com o CodeSee, visite o site oficial (https://www.codesee.io/) e siga as instruções para instalar a extensão do navegador e integrá-la com a sua conta do GitHub.ub account. +Para começar com o CodeSee, visite o site oficial (https://www.codesee.io/) e siga as instruções para instalar a extensão do navegador e integrá-la com a sua conta do GitHub. ## VS Code From 3bb7a2de76d723ded8d47b76354383cc7d3d647d Mon Sep 17 00:00:00 2001 From: Christine Belzie <105683440+CBID2@users.noreply.github.com> Date: Sat, 17 Feb 2024 15:29:51 -0500 Subject: [PATCH 59/62] fix: translate into Brazilian Portuguese Co-authored-by: Vitor Ayres --- translations/pt-br/04-ferramentas-utilizadas.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/translations/pt-br/04-ferramentas-utilizadas.md b/translations/pt-br/04-ferramentas-utilizadas.md index d1ec1548..1def8f5f 100644 --- a/translations/pt-br/04-ferramentas-utilizadas.md +++ b/translations/pt-br/04-ferramentas-utilizadas.md @@ -27,7 +27,7 @@ Git permite que os desenvolvedores acompanhem as alterações no seu código, co ### Introdução ao GitHub -O GitHub é uma plataforma baseada na web para controlo de versão e colaboração que utiliza o Git como tecnologia subjacente. Ele fornece uma interface simples e amigável para gerir repositórios Git, bem como uma série de recursos e ferramentas para colaborar com outros desenvolvedores. +O GitHub é uma plataforma baseada na web para controle de versão e colaboração que utiliza o Git como tecnologia subjacente. Ele fornece uma interface simples e amigável para gerir repositórios Git, bem como uma série de recursos e ferramentas para colaborar com outros desenvolvedores. Algumas das principais funcionalidades do GitHub incluem: From cc7f5cba8f3ca63be96bc1dd1f73e4c83ab5b576 Mon Sep 17 00:00:00 2001 From: Christine Belzie <105683440+CBID2@users.noreply.github.com> Date: Sat, 17 Feb 2024 15:31:00 -0500 Subject: [PATCH 60/62] fix: revise translation Co-authored-by: Vitor Ayres --- translations/pt-br/04-ferramentas-utilizadas.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/translations/pt-br/04-ferramentas-utilizadas.md b/translations/pt-br/04-ferramentas-utilizadas.md index 1def8f5f..462ad95d 100644 --- a/translations/pt-br/04-ferramentas-utilizadas.md +++ b/translations/pt-br/04-ferramentas-utilizadas.md @@ -22,7 +22,7 @@ Git é um sistema de controlo de versão distribuído projetado para lidar com p Git permite que os desenvolvedores acompanhem as alterações no seu código, colaborem com outros desenvolvedores e gerenciem várias versões dos seus projetos. Alguns dos recursos principais do Git incluem: - **Branch**: Git permite que os desenvolvedores criem ramificações, cópias separadas da sua base de código. Isso permite que eles trabalhem em novos recursos ou correções de bugs sem afetar a base de código principal. Uma vez que as alterações estejam concluídas, eles podem mesclar a ramificação de volta para a base de código principal. -- **Área de preparação(Stagging area)**: Git fornece uma área de preparação onde os desenvolvedores podem preparar as suas alterações antes de as comprometerem com o repositório. Isso permite que eles revisem e organizem as suas alterações antes de as tornarem permanentes. +- **Ambiente de preparação(Stagging area)**: Git fornece uma área de preparação onde os desenvolvedores podem preparar as suas alterações antes de as aplicarem ao repositório. Isso permite que eles revisem e organizem as suas alterações antes de as tornarem permanentes. - **Controle de versão distribuído**: Ao contrário dos sistemas de controlo de versão centralizados, o Git é um sistema de controlo de versão distribuído. Isso significa que cada desenvolvedor tem uma cópia completa do repositório na máquina local, permitindo-lhes trabalhar offline e independentemente de um servidor central. ### Introdução ao GitHub From 6fa01588e1f5e2a52f7c6c8e6de1043a06518eb6 Mon Sep 17 00:00:00 2001 From: Christine Belzie <105683440+CBID2@users.noreply.github.com> Date: Sat, 17 Feb 2024 15:32:28 -0500 Subject: [PATCH 61/62] fix: revise translation Co-authored-by: Vitor Ayres --- translations/pt-br/04-ferramentas-utilizadas.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/translations/pt-br/04-ferramentas-utilizadas.md b/translations/pt-br/04-ferramentas-utilizadas.md index 462ad95d..2b9e2779 100644 --- a/translations/pt-br/04-ferramentas-utilizadas.md +++ b/translations/pt-br/04-ferramentas-utilizadas.md @@ -23,7 +23,7 @@ Git permite que os desenvolvedores acompanhem as alterações no seu código, co - **Branch**: Git permite que os desenvolvedores criem ramificações, cópias separadas da sua base de código. Isso permite que eles trabalhem em novos recursos ou correções de bugs sem afetar a base de código principal. Uma vez que as alterações estejam concluídas, eles podem mesclar a ramificação de volta para a base de código principal. - **Ambiente de preparação(Stagging area)**: Git fornece uma área de preparação onde os desenvolvedores podem preparar as suas alterações antes de as aplicarem ao repositório. Isso permite que eles revisem e organizem as suas alterações antes de as tornarem permanentes. -- **Controle de versão distribuído**: Ao contrário dos sistemas de controlo de versão centralizados, o Git é um sistema de controlo de versão distribuído. Isso significa que cada desenvolvedor tem uma cópia completa do repositório na máquina local, permitindo-lhes trabalhar offline e independentemente de um servidor central. +- **Controle de versão distribuído**: Ao contrário dos sistemas de controle de versão centralizados, o Git é um sistema de controle de versão distribuído. Isso significa que cada desenvolvedor tem uma cópia completa do repositório na máquina local, permitindo-lhes trabalhar offline e independentemente de um servidor central. ### Introdução ao GitHub From d44fa5cf348a8d7896371b6d5f1110ed3e8858d3 Mon Sep 17 00:00:00 2001 From: Christine Belzie <105683440+CBID2@users.noreply.github.com> Date: Sat, 17 Feb 2024 15:33:09 -0500 Subject: [PATCH 62/62] fix: revise translation in Brazilian Portuguese Co-authored-by: Vitor Ayres --- translations/pt-br/04-ferramentas-utilizadas.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/translations/pt-br/04-ferramentas-utilizadas.md b/translations/pt-br/04-ferramentas-utilizadas.md index 2b9e2779..d2f0d6db 100644 --- a/translations/pt-br/04-ferramentas-utilizadas.md +++ b/translations/pt-br/04-ferramentas-utilizadas.md @@ -17,7 +17,7 @@ Antes de completar o seguinte passo a passo, complete o seguinte: ### Introdução ao Git -Git é um sistema de controlo de versão distribuído projetado para lidar com projetos pequenos e muito grandes com velocidade e eficiência. Foi criado por Linus Torvalds, o criador do kernel Linux, para gerir o desenvolvimento do próprio kernel Linux. +Git é um sistema de controle de versão distribuído projetado para lidar com projetos pequenos e muito grandes com velocidade e eficiência. Foi criado por Linus Torvalds, o criador do kernel Linux, para gerir o desenvolvimento do próprio kernel Linux. Git permite que os desenvolvedores acompanhem as alterações no seu código, colaborem com outros desenvolvedores e gerenciem várias versões dos seus projetos. Alguns dos recursos principais do Git incluem: