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

El volumen de transacciones con CBDC se multiplicará por 25 hasta 2031

En los próximos años asistiremos al ‘boom’ de las monedas digitales de bancos centrales. En…

10 horas ago

Estas son las amenazas a la seguridad que marcarán 2025

La popularidad de la tecnología de inteligencia artificial se dejará notar el año que viene…

1 día ago

Los ciberdelincuencia alcanza a un 96 % de las empresas españolas

La mayoría de las compañías de nuestro país ha sido blanco de los cibercriminales en…

1 día ago

Seresco facturó casi 24 millones de euros durante el primer semestre

Experimentó una mejoría del 20 % en comparación con los seis primeros meses del ejercicio…

1 día ago

Econocom mantiene sus objetivos de crecimiento

La compañía espera incrementar sus ingresos entre un 3 % y un 5 % en…

1 día ago

Showroomprivé Marketplace llega a España

Este proyecto complementario a la oferta de ventas flash ya existe en Francia y Bélgica…

1 día ago