diff --git a/README.md b/README.md index 42b214d0..c39b965b 100644 --- a/README.md +++ b/README.md @@ -10,10 +10,10 @@ 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) +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) +[Portuguese Brazilian](translations/pt-br/README.md) ## Course Overview The course is divided into six chapters, each covering a different aspect of open source: diff --git a/_layouts/navbar.md b/_layouts/navbar.md index f14c4c2d..5367175c 100644 --- a/_layouts/navbar.md +++ b/_layouts/navbar.md @@ -1,5 +1,6 @@ -- [Home Page](/) -- [⭐ Star The Repo](https://github.com/open-sauced/intro) -- Languages - - [:us: English ](/) - - [:fr: French ](/translations/fr/) +* [Home Page](/) +* [⭐ Star The Repo](https://github.com/open-sauced/intro) +* Languages + * [:us: English](/) + * [:fr: French](/translations/fr/) + * [🇧🇷 Portuguese](/translations/pt-br/) diff --git "a/translations/fr/06-la-sauce-secr\303\250te.md" "b/translations/fr/06-la-sauce-secr\303\250te.md" index 9ae35256..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 ->](07-conclusion.md) +[Section suivante ->](/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 + 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 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/fr/_layouts/navbar.md b/translations/fr/_layouts/navbar.md index df733200..e328982f 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/) + * [🇧🇷 Portugais](/translations/pt-br/) 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) 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..6f295397 --- /dev/null +++ "b/translations/pt-br/01-introdu\303\247\303\243o.md" @@ -0,0 +1,71 @@ +# 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 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 + +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ê 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. + +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, 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 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 + +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á 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. + +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 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. +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 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. + +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 ->](/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" new file mode 100644 index 00000000..956313b2 --- /dev/null +++ "b/translations/pt-br/02-o-que-\303\251-open-source.md" @@ -0,0 +1,73 @@ +# O que é Open Source? + +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 "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 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 + +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 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 + +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 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. + +[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 new file mode 100644 index 00000000..6b47488a --- /dev/null +++ b/translations/pt-br/03-por-que-open-source.md @@ -0,0 +1,61 @@ +# 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 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. + +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, 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. + +## 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 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. + +## 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 -->](/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 new file mode 100644 index 00000000..d2f0d6db --- /dev/null +++ b/translations/pt-br/04-ferramentas-utilizadas.md @@ -0,0 +1,142 @@ +# 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 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: + +- **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 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 + +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: + +- **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](../../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. + +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. + +## 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, 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 operacional. + +## 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) + + +✏️ 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 new file mode 100644 index 00000000..97bd17d2 --- /dev/null +++ b/translations/pt-br/05-como-contribuir-para-open-source.md @@ -0,0 +1,52 @@ +# 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. + +### 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-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 new file mode 100644 index 00000000..0e64c760 --- /dev/null +++ b/translations/pt-br/06-o-segredo-do-sauce.md @@ -0,0 +1,82 @@ +# 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](../../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. + +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-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" new file mode 100644 index 00000000..cf473fe5 --- /dev/null +++ "b/translations/pt-br/07-tipos-de-contribuic\314\247o\314\203es.md" @@ -0,0 +1,109 @@ +# 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 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) + +**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 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. + +### 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 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 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 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 + +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.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 + +- **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 ->](/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 new file mode 100644 index 00000000..d20e94fb --- /dev/null +++ b/translations/pt-br/08-recursos-adicionais.md @@ -0,0 +1,31 @@ +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 + +- [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. + +## 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) + +- [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) + +- [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" new file mode 100644 index 00000000..f9167439 --- /dev/null +++ "b/translations/pt-br/09-conclus\303\243o.md" @@ -0,0 +1,45 @@ +# 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 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: + +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! + +[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" new file mode 100644 index 00000000..15ac471d --- /dev/null +++ "b/translations/pt-br/10-gloss\303\241rio.md" @@ -0,0 +1,49 @@ +## Repositório + +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. + +## Membro Principal + +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. + +## Issue + +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 + +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 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. + +## Fork + +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. + +## Branch + +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. + +## Pull Request + +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. + +## Merge + +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. + +## 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)! + + +✏️ Editar esta página + \ No newline at end of file diff --git a/translations/pt-br/README.md b/translations/pt-br/README.md new file mode 100644 index 00000000..ce765ee9 --- /dev/null +++ b/translations/pt-br/README.md @@ -0,0 +1,59 @@ +
+
+ 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 +Assim como a pizza, open source deve ser compartilhado com todos. Clique nos links abaixo para seguir este curso nos seguintes idiomas diferentes: + +[French](/translations/fr/README.md) +[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! + +🤝 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) diff --git a/translations/pt-br/_layouts/navbar.md b/translations/pt-br/_layouts/navbar.md new file mode 100644 index 00000000..3b291ff2 --- /dev/null +++ b/translations/pt-br/_layouts/navbar.md @@ -0,0 +1,6 @@ +* [Pagina inicial](/) +* [⭐ 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) diff --git a/translations/pt-br/_layouts/sidebar.md b/translations/pt-br/_layouts/sidebar.md new file mode 100644 index 00000000..f8ae689d --- /dev/null +++ b/translations/pt-br/_layouts/sidebar.md @@ -0,0 +1,11 @@ +- 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-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