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

Se dispara el interés por las carreras tecnológicas en España

Las consultas en Google revelan un auge de peticiones de información sobre estudios relacionados con…

18 horas ago

Zscaler llega a un acuerdo para adquirir Red Canary

La compañía que Zscaler quiere comprar proporciona servicios de detección y respuesta gestionadas.

19 horas ago

Red Hat apuesta por los vehículos definidos por software

Red Hat In-Vehicle Operating System busca "remodelar" la industria de la automoción.

20 horas ago

España tiene 125,6 líneas de telefonía móvil por cada 100 habitantes

Mientras, la proporción de líneas de banda ancha fija es de 38,7 por cada 100…

20 horas ago

Un 84 % de los responsables de TI españoles planea incrementar el presupuesto de tecnología asignado a la red

En nuestro país, 7 de cada 10 compañías han sufrido cortes importantes por congestión, ciberataques…

21 horas ago

Logicalis Spain reafirma su compromiso con la sostenibilidad

El proveedor de servicios de TI y soluciones digitales ha conseguido reducir  su gasto energético…

21 horas ago