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 mercado WLAN empresarial mejoró en los meses de enero, febrero y marzo

IDC calcula un crecimiento interanual del 10,6 % durante el primer trimestre de 2025 para…

9 horas ago

El gasto en servicios de infraestructura en la nube rozó los 91.000 millones de dólares durante el primer trimestre

AWS, Microsoft Azure y Google Cloud son los principales proveedores, aglutinando un 65 % del…

10 horas ago

Ahora Sophos Firewall incluye Sophos NDR Essential

Esta funcionalidad permite identificar comunicaciones de malware desconocidas o que no han sido registradas.

10 horas ago

CrowdStrike integra Falcon Cloud Security con los microservicios LLM NIM y NeMo Safety de NVIDIA

Esta asociación está pensada para ejecutar y escalar con seguridad aplicaciones basadas en modelos de…

11 horas ago

Commvault y Kyndryl colaborarán con Pure Storage para mejorar el cumplimiento normativo

Trabajarán juntas para facilitar el respeto de normas como DORA, NIS2 y PSD2 en la…

12 horas ago

AWS re:Inforce: “La seguridad está en los cimientos de la innovación cloud”

AWS está celebrando en Filadelfia su evento anual sobre ciberseguridad, un área considerada fundamental para…

23 horas ago