Sua organização no Github: Como começar

Pachi 🥑 - Apr 28 '23 - - Dev Community

O GitHub você já conhece né? Mas você sabia que existem 2 tipos de perfis principais lá dentro? Você provavelmente tem seu perfil pessoal, que você usa para seus projetos e contribuições. Mas lá também temos a opção de criar organizações, ou orgs, que podem ser criadas para projetos, comunidades e até empresas.

No artigo de hoje eu vou falar sobre o que são Orgs, como criar uma e algumas das funcionalidades que elas trazem.

Tive a ideia desse artigo para ajudar a Karina Watanabe a trazer o Projeto Lyme Brasil, um projeto com o objetivo de trazer visibilidade e acessibilidade a doença de Lyme no Brasil, para o GitHub.

O que é uma Org no Github?

Organizações basicamente são perfis de grupos, contas compartilhadas por pessoas trabalhando e contribuindo no mesmo projeto, e o número de pessoas que podem participar é ilimitado.

Lá você pode ter várias pessoas como administradoras e dar às pessoas contribuidoras diferentes níveis de acesso a org em geral e aos repositórios dela.

Quando você visita o perfil de alguém no GitHub, se você for até o fim da coluna de perfil na esquerda você encontra a aba de organizações. Uma pessoa pode criar ou ser parte de diversas Orgs, públicas ou privadas. Se a empresa na qual você trabalha usa o GitHub, você provavelmente já é parte de uma organização no GitHub.

lista de orgs

Na imagem acima, você pode ver a minha lista de Organizações. Tem comunidades tech, uma agência de web, projetos do qual faço parte e orgs relacionadas ao meu trabalho. Com base nisso você pode ter uma ideia da variedade de possibilidades que as Orgs do GitHub trazem.

Se você tem um projeto que quer crescer, ter uma organização traz mais seriedade e credibilidade do que apenas ter um repositório na sua conta principal.

Criando uma Org

Para criar sua organização dentro do GitHub, você precisa ter uma conta pessoal, vamos ao passo a passo:

  1. Na página inicial, clique no seu ícone de perfil no canto superior direito, que que vai abrir um menu dropdown

  2. Nesse menu procure e clique em Your organizations

  3. Aqui você pode ver as organizações das quais você já faz parte, clique no botão New organization

botao new organization

  1. Você verá opções de planos, e neste exemplo vamos usar o gratuito, porque nosso projeto imaginário é pequeno e não temos dinheiro hihi

  2. A próxima página é para você configurar sua org, com o nome e o email de contato. Aqui o GitHub também pergunta se essa organização vai pertencer a sua conta pessoal ou a uma instituição ou negócio. Vamos escolher a opção My personal account

  3. O próximo passo é adicionar pessoas a sua org, mas você pode pular se estiver começando sozinha

  4. E temos nossa organização!

pagina inicial new org

Na página inicial você encontra dicas de ações para fazer pra começar sua org com o pé direito, não são obrigatórias, são apenas para te ajudar nesse começo e te dar ideias.

Nas configurações da sua Org você pode colocar uma imagem de perfil, descrição, redes sociais, localização e outras informações de personalização.

Dentro da sua Organização você tem muitas opções do que fazer, boa parte, muito similar ao seu perfil pessoal. Como esse artigo é introdutório não vou falar sobre todos os detalhes, mas se você tiver alguma dúvida, pergunte nos comentários!

Boas Práticas

A primeira dica aqui é que a org tenha mais de uma pessoa responsável por ela, até porque se apenas uma pessoas estiver como responsável e ela ficar ausente por alguma razão, o projeto ficará inacessível para a comunidade. Então para garantir a segurança do projeto, recomendamos que ele tenha pelo menos 2 pessoas responsáveis.

Tenha a página principal o mais completa possível, com uma imagem de perfil, descrição e uma forma de contato, como no exemplo abaixo do Bootgly, priojeto do Rodrigo Vieira.

intro projeto

Use o GitHub Discussions para comunicação do projeto com as suas pessoas colaboradoras e comunidade. Ele é um fórum dentro do GitHub, que pode ser usado em um repositório ou em uma organização. Dentro dele você pode fazer perguntas, compartilhar ideias e criar conexões com outras pessoas que contribuem para os mesmo projetos que você ou fazem parte da mesma org. Você pode aprender mais sobre essa ferramenta nesse artigo.

De que Organizações você faz parte?

Você já faz parte de alguma? Quais? Comenta ai!

E se você tem ideias legais para criar uma do zero, compartilhe com a gente também.

Obrigada por lerem até aqui 💖

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .