Contribución open source en C#: por dónde empezar y no volverse loco

¿Por qué el open source no da miedo, sino que es beneficioso?

Muchos desarrolladores, especialmente en C#, miran el open source con recelo. Parece que solo hay gurús esperando criticar tu código. En realidad, la contribución open source es la mejor manera de mejorar tus habilidades, ganar experiencia trabajando en un equipo grande y hacer amigos en todo el mundo.

Yo mismo tardé mucho en hacer mi primer Pull Request. Pensaba: «¿Quién soy yo para meterme en el código que escribieron los profesionales?». Pero luego simplemente corregí un error tipográfico en la documentación, y todo empezó. Ahora tengo más de 50 merges en diferentes proyectos C#. Y quiero contarles cómo empezar a contribuir en open source sin estrés innecesario.

Paso 1. Encuentra tu «arenero»

No te metas directamente en el núcleo de ASP.NET Core o Roslyn. Empieza con algo pequeño. Aquí hay tres tipos de proyectos donde te recibirán con los brazos abiertos:

• Bibliotecas para C# — hay miles en GitHub. Búscalas con las etiquetas csharp, dotnet, library.
• Herramientas para desarrolladores — analizadores de código, generadores, utilidades.
• Documentación — sí, también es open source. Y a menudo tiene más «huecos».

Una excelente manera de encontrar un proyecto es ir a GitHub y buscar label:"good first issue" language:csharp. Estas son etiquetas especiales para principiantes. Estas tareas están marcadas como simples y fáciles de entender.

Paso 2. Familiarízate con las herramientas

Antes de escribir código, asegúrate de tener:

• Git (preferiblemente por consola, no GUI)
• Visual Studio o Rider (la Community Edition es suficiente)
• Una cuenta en GitHub
• Conocimiento básico de git clone, git branch, git commit, git push

Si todavía no dominas Git, no te preocupes. Simplemente haz un fork del proyecto, realiza cambios a través de la interfaz de GitHub y crea un Pull Request desde allí. Es la forma más fácil para la primera vez.

Paso 3. Encuentra un error o una funcionalidad

Supongamos que elegiste un proyecto. ¿Qué hacer después? Abre la pestaña Issues y busca tareas con etiquetas:

• good first issue
• help wanted
• beginner
• documentation

Si no encuentras nada, no dudes en escribir en los comentarios: «¡Hola! Soy nuevo, quiero ayudar. ¿Hay algo sencillo?». Créeme, los mantenedores suelen ser muy amigables. Ellos también empezaron alguna vez.

Paso 4. Escribe código (con ejemplo)

Imaginemos que encontraste un error: en un método de extensión para cadenas no se maneja el caso null. Así es como podría verse.

Código original (con error):

public static class StringExtensions{    public static string Reverse(this string input)    {        char[] chars = input.ToCharArray();        Array.Reverse(chars);        return new string(chars);    }}

Tu corrección:

public static class StringExtensions{    public static string Reverse(this string input)    {        if (input == null)            throw new ArgumentNullException(nameof(input));

        char[] chars = input.ToCharArray();        Array.Reverse(chars);        return new string(chars);    }}

¿Ves? Nada del otro mundo. Simplemente agregaste una comprobación de null y lanzaste la excepción correcta. Esto ya es una contribución open source digna.

Paso 5. Escribe pruebas unitarias

Una buena práctica es agregar pruebas a tu código. Aquí hay un ejemplo para nuestra corrección usando xUnit:

public class StringExtensionsTests{    [Fact]    public void Reverse_ValidString_ReturnsReversed()    {        var result = "hello".Reverse();        Assert.Equal("olle