Este tópico apresenta as principais ferramentas que você precisa para trabalhar com um projeto open-source e o GitHub.
Este tutorial sugere algumas ferramentas específicas para fins de exemplo, mas todas elas têm alternativas que funcionam de um jeito parecido.
Conforme explicado no tópico sobre Git e GitHub, o Git funciona a base de comandos executados em um terminal. Clientes Git são softwares que servem de interface para executar os mesmos comandos, mas de maneira visual em vez de um terminal.
O GitHub disponibiliza seu próprio cliente gratuito, o GitHub Desktop, mas existem diversas alternativas que você pode buscar.
É perfeitamente possível trabalhar somente com os comandos do Git. Mas, para este tutorial, vamos usar o Sublime Merge - um dos muitos clientes Git - para executar as operações do Git.
Um IDE (ou Ambiente de Desenvolvimento Integrado, em português) é um software que inclui múltiplas funcionalidades voltadas para o desenvolvimento.
IDEs vão muito além da capacidade de escrever o código. Eles permitem usar uma série de extensões e recursos que facilitam o trabalho, como por exemplo: validadores de código; integração com sistemas de controle de versão.
No trabalho de tech writers, é comum trabalharmos com o conceito de docs-as-code (abordado no tópico de terminologia). O uso de um IDE é melhor do que um simples editor de texto neste caso. Acabamos usando o IDE como um software que permite editar texto e código (text+code) de maneira integrada com o sistema de controle de versão e com os projetos de desenvolvimento.
Um bom IDE e editor de código é o Visual Studio Code (VS Code), por ser bem completo e integrar bem com ambientes de desenvolvimento. O VSCode costuma ter mais funcionalidades e plugins disponíveis.
Outra alternativa é o Sublime Text, que é mais básico e fácil para quem nunca mexeu com esse tipo de software antes. O Sublime Text é mais limpo e intuitivo, mas tem menos funcionalidades.
Para este tutorial, vamos usar o VS Code.
Se você quer aprender a lidar com o Git de forma “raiz”, você pode instalá-lo na sua máquina. Você irá fazer todas as operações via linha de código ao invés de usar uma interface gráfica.
A versão atual deste tutorial não ensina as linhas de comando do Git, então não é necessário instalá-lo para seguir com as lições. Vamos usar interfaces gráficas de clientes Git para fazer o trabalho.