Cómo crear y administrar una organización en GitHub

Andrea Liliana Griffiths - May 10 '23 - - Dev Community

¿Ya conoces GitHub, verdad? Pero, ¿sabías que existen dos tipos principales de perfiles dentro de esta plataforma? Probablemente ya tengas tu perfil personal, que utilizas para tus proyectos y contribuciones, pero también hay una opción para crear organizaciones, o "orgs", que pueden ser creadas para proyectos, comunidades e incluso empresas.

En este artículo, te explicaré qué son las orgs, cómo crear una y algunas de las funcionalidades que ofrecen.

¿Qué es una org en GitHub?

Las organizaciones son básicamente perfiles de grupos, cuentas compartidas por personas que trabajan y contribuyen en el mismo proyecto, y el número de personas que pueden participar es ilimitado.

Allí puedes tener varias personas como administradoras y dar diferentes niveles de acceso a las personas que contribuyen a la org en general y a sus repositorios.

Cuando visitas el perfil de alguien en GitHub, si vas hasta el final de la columna de perfil a la izquierda, encontrarás la pestaña de organizaciones. Una persona puede crear o ser parte de diversas orgs, públicas o privadas. Si la empresa en la que trabajas utiliza GitHub, es probable que ya seas parte de una organización en GitHub.

Lista de organizaciones

En la imagen de arriba, puedes ver mi lista de Organizaciones. Hay comunidades tech, la organización comunitaria de GitHub Presente, proyectos en los que participo y orgs relacionadas con mi trabajo. Con base en eso, puedes tener una idea de la variedad de posibilidades que las orgs de GitHub ofrecen.

Si tienes un proyecto que quieres hacer crecer, tener una organización le da más seriedad y credibilidad que tener solo un repositorio en tu cuenta principal.

Creando una org

Para crear tu organización dentro de GitHub, necesitas tener una cuenta personal. Sigue los siguientes pasos:

  1. En la página principal, haz clic en tu icono de perfil en la esquina superior derecha, que abrirá un menú desplegable.

  2. En ese menú, busca y haz clic en "Tus organizaciones".

  3. Aquí puedes ver las organizaciones a las que ya perteneces. Haz clic en el botón "Nueva organización".

  4. GitHub ofrece la posibilidad de crear una organización de forma gratuita, lo cual es una excelente opción para aquellos que tienen proyectos en equipo o incluso para empresas pequeñas que buscan una plataforma para gestionar sus repositorios.

imagen creando nueva organizacion

  1. La siguiente página es para que configures tu org, con el nombre y el correo electrónico de contacto. Aquí GitHub también pregunta si esa organización pertenecerá a tu cuenta personal o a una institución o negocio. Elegiremos la opción "Mi cuenta personal".

Image description

  1. El siguiente paso es agregar personas a tu org, pero puedes saltar esto si estás comenzando sola.

¡Y ya tienes tu organización!

En la página principal, encontrarás consejos de acciones para empezar con el pie derecho. No son obligatorias, solo te ayudarán al principio y te darán ideas.

gif mostrando la pagina de bienvenida

En las configuraciones de tu org, puedes poner una imagen de perfil, descripción, redes sociales, ubicación y otra información de personalización.

Dentro de tu organización, tienes muchas opciones de lo que hacer, la mayoría muy similar a las opciones que tienes en tu perfil personal. Como este artículo es introductorio, no hablaré sobre todos los detalles, pero si tienes alguna duda, ¡pregunta en los comentarios!

Buenas prácticas

El primer consejo aquí es que la org tenga más de una persona responsable, ya que si solo una persona está a cargo y está ausente por alguna razón, el proyecto será inaccesible para la comunidad. Por lo tanto, para garantizar la seguridad del proyecto, recomendamos que tenga al menos dos personas responsables.

Haz que la página principal sea lo más completa posible, con una imagen de perfil, una descripción y una forma de contacto, puedes incluir más detalles en un archivo README como en el ejemplo a continuación de la organización de GitHub.

readme de la organización GitHub

Usa GitHub Discussions para comunicarte con tus colaboradores y la comunidad del proyecto. Es un foro dentro de GitHub que se puede utilizar en un repositorio o en una organización. Dentro de él, puedes hacer preguntas, compartir ideas y crear conexiones con otras personas que contribuyen a los mismos proyectos que tú o que forman parte de la misma org. Puedes obtener más información sobre esta herramienta en este artículo.

¿De qué organizaciones eres parte?
¿Ya eres parte de alguna organización? ¿Cuáles? ¡Comenta aquí! Y si tienes ideas geniales para crear una desde cero, compártelas con nosotros también.

¡Gracias por leer hasta aquí 💖 y gracias especiales @pachicodes por escribir este artículo tan útil!

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