El Manual de estilo de Microsoft: su guía diaria de uso, terminología y estilo para comunicaciones técnicas profesionales ( MSTP ), en ediciones anteriores el Manual de estilo de Microsoft para publicaciones técnicas , fue una guía de estilo publicada por Microsoft . La cuarta edición, ISBN 0-7356-4871-9 , se publicó en 2012. Los empleados y socios de Microsoft también tuvieron acceso a una versión de Ayuda HTML comprimida (CHM) de Microsoft.
En 2018, el libro fue reemplazado por un sitio web, Microsoft Writing Style Guide, uniéndose a otras guías en línea como Apple Style Guide y Google Developer Documentation Style Guide.
Historia
Objetivo
Al igual que cualquier guía de estilo , la MSTP establece estándares y sirve como referencia para los escritores. La MSTP tiene el propósito específico de guiar a los escritores técnicos, editores y administradores de contenido que trabajan con productos de Microsoft . Si bien el manual se centra en algunas partes en el uso específico de estos productos, la guía también sirve como una herramienta general para los escritores técnicos. El contenido varía desde instrucciones específicas para nombrar elementos particulares de programas específicos hasta reglas generales de gramática .
Contenido
El MSTP se divide en dos partes, precedidas de un prólogo y una introducción.
La Parte 1 se titula “Temas generales” y se subdivide en los siguientes 11 capítulos:
- Contenido para la web: define parámetros para todos los tipos de contenido web, incluidos web, video, blog, consideraciones internacionales y consideraciones de accesibilidad y legales.
- Estilo y voz de Microsoft: principios básicos y guía de estilo.
- Contenido para una audiencia mundial: proporciona instrucciones para garantizar que los documentos se entiendan en todo el mundo evitando referencias locales y haciendo que los textos sean fáciles de traducir.
- Contenido accesible: habla sobre la accesibilidad en todas las áreas, incluido el diseño, los gráficos y el texto; hace referencia a la terminología aceptable.
- La interfaz de usuario: proporciona nombres estandarizados para los elementos de la interfaz de usuario de Microsoft .
- Procedimientos y contenido técnico: proporciona pautas para un formato uniforme de procedimientos y otro contenido técnico para ayudar a los usuarios a encontrar información importante de forma rápida y eficiente.
- Cuestiones prácticas de estilo: señala problemas comunes que van desde la capitalización hasta el formato de elementos de estilo como fechas, números y medidas.
- Gramática: Contiene secciones sobre el uso general de verbos y sustantivos.
- Puntuación: contiene información sobre el uso de la puntuación.
- Índices y palabras clave: proporciona pautas para indexar y/o atribuir contenido para garantizar que los usuarios puedan descubrirlo.
- Acrónimos y otras abreviaturas: proporciona pautas sobre el uso uniforme de acrónimos y abreviaturas, incluido cómo y cuándo utilizarlos para evitar confusiones. También contiene una lista de acrónimos y abreviaturas.
La Parte 2 es un "Diccionario de uso" organizado alfabéticamente con términos comúnmente utilizados en la redacción técnica.
Enlaces externos
