Sobre o GitHub Codespaces
GitHub Codespaces permite que você trabalhe em um ambiente de desenvolvimento hospedado remotamente do computador. Você pode começar rapidamente, sem precisar configurar o ambiente de trabalho ou baixar arquivos no computador local.
Para saber mais, confira Guia Rápido para GitHub Codespaces.
Como trabalhar na documentação em um codespace
As etapas a seguir pressupõem que você tenha GitHub Codespaces configurado para editar arquivos usando Visual Studio Code para a Web. As etapas serão muito semelhantes se você tiver definido um editor diferente. Para saber mais, confira Definindo seu editor padrão para GitHub Codespaces.
-
Acesse o repositório de código aberto de GitHub Docs,
github/docs. -
Se você for um colaborador de código aberto, crie um fork do repositório e siga o restante das etapas neste procedimento por meio do seu fork. Para saber mais, confira Criar fork de um repositório.
-
Crie um ramo para trabalhar. Para saber mais, confira Gerenciando branches em seu repositório.
-
Na página principal do repositório, clique em Código e, em seguida, clique em Criar codespace no BRANCH-NAME.
A página "Como configurar seu codespace" será exibida. Após pouco tempo, a versão de Visual Studio Code no navegador é exibida.
-
Use o Explorer para navegar até o arquivo markdown que deseja editar. Se o arquivo for um artigo, ele estará localizado no diretório
content. Se o arquivo for um conteúdo reutilizável, ele estará localizado no diretóriodata.Na maioria dos casos, o caminho para um artigo no diretório
contentcorresponde ao caminho na URL, menos a extensão de arquivo.md. Por exemplo, a origem do artigohttps://docs.github.com/en/codespaces/quickstarté o arquivo markdowncontent/codespaces/quickstart.md. -
Edite o arquivo markdown conforme necessário.
-
Salve suas alterações.
-
Realize o commit e o push das suas alterações, usando a exibição Controle de Versão ou os comandos Git no Terminal. Para saber mais, confira Sobre o Git.