Categories: ProyectosWorkspace

Google publica su propia guía de estilo para desarrolladores

Para ayudar a los desarrolladores a redactar mejor documentación y ampliar la posibilidad de participar en proyectos, Google ha hecho pública esta semana su propia guía de estilo para desarrolladores.

A menudo, la oferta y disponibilidad de documentación de desarrollo se ofrece de forma tardía a los desarrolladores, especialmente en los proyectos de código abierto, lo que dificulta la adaptación de los recién llegados a un proyecto.

En el caso de Google, esta es la misma guía de estilo que el gigante de Internet usa internamente para escribir la documentación de sus propios proyectos, como Kubernetes y Dart.

La guía incluye de todo, desde una lista de palabras para asegurar la ortografía de la jerga que se utiliza en la industria, a cómo y cuándo usar guiones o por qué se deben utilizar activos de voz y otros elementos básicos. Sin embargo, donde los desarrolladores deben prestar especial atención es a las indicaciones sobre cómo escribir buenos comentarios del código API y cómo documentar mejor la sintaxis de la línea de comandos.

Otras compañías, como WordPress y Salesforce, también han hecho públicas sus guías de estilo.

El equipo detrás de la guía de Google ha señalado que se trata de un documento vivo y que cambiará con el tiempo. También ha enfatizado que es solo una manera de hacer las cosas y no un estándar para la industria.

Rosalía Rozalén

Periodista especializada en Tecnología desde hace más de una década. Primero informando sobre el canal de distribución, después sobre las grandes corporaciones y ahora hacia un enfoque más IT Pro. Apasionada de la comunicación con la revolución social media que estamos viviendo.

Recent Posts

España, mejor que la media en equidad de género sobre inteligencia artificial

Un 54,7 % de los trabajadores formados en IA en nuestro país son hombres y…

7 horas ago

En España, 1 de cada 3 empleados utiliza IA en su día a día

Las aplicaciones más pujantes son las de traducción automática, los chatbots y los asistentes de…

8 horas ago

La falta de talento obstaculiza la adopción de IA en la industria

La mayoría de las empresas carece de personal con las competencias necesarias para trabajar con…

9 horas ago

¿Cómo afrontan los españoles el Black Friday?

Solamente 1 de cada 10 no aprovechará las rebajas, el 70 % gastará lo mismo…

10 horas ago

La ciberseguridad del IoT crecerá un 120% en el próximo lustro

El internet de las cosas (IoT) trae muchas ventajas, pero también comporta nuevos riesgos. El…

2 días ago

Bitdefender lanza un programa de garantía contra violaciones de seguridad

Ofrece hasta 1 millón de dólares de compensación económica en caso de incidente, con la…

3 días ago