¿Cómo redactar Una especificación técnica?
Hacer un boceto de la especificación técnica
Proporciona una descripción general o un breve resumen del proyecto o el producto. Incluye una sección de objetivos si no se encuentra en la descripción general o el resumen breve. Escribe los requisitos del producto en una sección separada. Explica cosas que estén fuera del alcance del proyecto. Incluye una sección de “Preguntas abiertas” si existen problemas sin resolver. Presenta el plan en la sección “Enfoque”. Incluye las otras opciones que has considerado pero que has descartado. Describe tus métodos y medidas para evaluar el producto o el proyecto. Identifica cómo vas a proporcionar seguridad y privacidad. Termina con un cronograma y una lista de hitos.
Comienza la especificación técnica con un resumen de lo que estás haciendo. Escribe “Descripción general” o “Resumen breve” como encabezado. Explica el problema y luego resume la descripción del proyecto o el producto y lo que va a hacer. A continuación, explica cuál será tu enfoque para lograrlo e incluye especificaciones del producto si se trata de un equipamiento. Puedes vincular la especificación técnica a cualquier documento de marketing o ingeniería que sea relevante para el proyecto. Por último, proporciona un cálculo aproximado del tiempo que te tomará terminar el proyecto o el producto. Puedes escribir lo siguiente: “El sistema actual para planificar viajes de tránsito en todo el condado suele dejar a los pasajeros varados y reduce la cantidad de pasajeros en ciertas rutas. Dos de los sistemas de autobuses permiten a los pasajeros planificar sus recorridos a través de internet, pero el tercero emplea mapas físicos y contactos telefónicos. Esta solución reduce la cantidad de pasajeros y provoca una financiación insuficiente, como se puede apreciar en los resultados de la encuesta de la primavera del año 2019. El objetivo es trasladar las 3 líneas de tránsito a 1 sistema de planificación al que los usuarios puedan acceder a través de internet. Esta herramienta les permitirá planificar sus viajes con más facilidad y determinar cuándo se encontrarán los autobuses en cada parada. Además, los pasajeros pueden utilizar la función “contáctenos” para informar los problemas de inmediato”. Escribe “Objetivos” en el encabezado y luego describe brevemente lo que planeas lograr con el proyecto o el producto. Escribe un resumen introductorio y luego utiliza números o viñetas para enlistar los objetivos.  Si describes los objetivos en la sección de la descripción general, entonces esta sección no será necesaria. Sin embargo, es probable que tengas que incluir esta sección si en tu lugar de trabajo la requieren. Puedes escribir algo como “El nuevo sistema incluirá lo siguiente: 1) una herramienta para planificar las rutas, 2) una función para localizar buses, 3) un medio para que los ciclistas informen problemas”. Luego, escribe “Requisitos del producto” en el encabezado, seguido de las cosas que el producto debe hacer para resolver tu problema. Utiliza una lista de viñetas y no te preocupes por redactar una frase introductoria. Por ejemplo, “1) El planificador de rutas garantiza que los pasajeros no se queden varados y que los autobuses no se infrautilicen, 2) El buzón de contactos permite que los planificadores de tránsito respondan de manera directa a los problemas de los pasajeros”. Puedes titular esta sección como “Fuera de alcance” o “No dirigido a los objetivos”. No escribas una introducción ni párrafos. En su lugar, debes crear una lista con viñetas de las cosas que no vas a hacer para resolver tu problema. Este detalle incluye el trabajo que no vas a realizar, las soluciones que no crees que van a funcionar y los atributos que el producto o el proyecto no tendrá. Debes ser minucioso para evitar que surjan malentendidos entre el cliente y tu equipo. Puedes escribir: “1) Este sistema no agregará rutas nuevas para los autobuses, 2) No instalaremos computadoras en las paradas de autobús ni en los propios autobuses, por lo que los pasajeros deben emplear sus propios dispositivos, 3) Los planificadores de tránsito no garantizarán soluciones inmediatas a los problemas de los pasajeros, y 4) Este servicio no incluirá paradas de una puerta a otra”. Tu especificación técnica constituye un resumen rápido del producto o el proyecto para que el cliente comprenda lo que va a conseguir y tu equipo trabaje hacia los mismos objetivos. No te preocupes por incluir cada detalle o responder preguntas “por determinar”. En su lugar, debes escribir “Preguntas abiertas” en el encabezado y presentar una lista con viñetas de las cosas que vas a determinar más adelante. Puedes escribir: “1) ¿Cómo vamos a gestionar las actualizaciones del sistema? 2) ¿Vamos a cambiar los mapas de ruta si se detecta algún problema? 3) ¿El sistema es capaz de servir a una cantidad de pasajeros multilingües sin errores de traducción? 4) ¿Cómo haremos para servir mejor a los ciclistas que no son expertos en tecnología?”. Puedes titular esta sección como “Plan” o “Enfoque”. Describe cómo vas a resolver el problema o los diferentes enfoques que estás considerando si aún no has tomado una decisión final. Explica tu investigación y cada tecnología o proceso que vas a emplear. Si es posible, incluye ilustraciones, cuadros y diagramas para que a tus lectores les resulte más sencillo comprender tu plan. Por último, analiza cómo vas a probar tu plan y qué harás si surgen problemas.  Si describes enfoques o tecnologías diferentes, debes crear una subsección para cada uno de manera que tu plan sea fácil de seguir. Puedes escribir algo como lo siguiente: “Vamos a trabajar con el equipo de planificación de tránsito para diseñar un software que les permita a los pasajeros ingresar sus destinos en una aplicación que generará una ruta para ellos. Los ciclistas pueden modificar la ruta si lo desean. El sistema enviará actualizaciones de texto a los pasajeros para ayudarlos a encontrar sus rutas. Vamos a hacer que los usuarios de un comité de partes interesadas prueben el software antes de lanzarlo al público. Si el plan presenta errores, realizaremos actualizaciones en la página durante las horas en que los autobuses se encuentren desconectados. Además, tendremos un autobús de enlace adicional disponible para recoger a los pasajeros que se queden varados debido a problemas con el sistema”. Puedes redactar esta sección como un subpaso en tu plan o enfoque o colocarla al final de la especificación antes del cronograma. Escribe el encabezado “Otras opciones consideradas” y luego describe las alternativas que consideraste antes de escoger el plan actual. Luego, explica por qué descartaste cada opción. Puedes escribir lo siguiente: “Consideramos los mapas codificados por colores porque son una opción más económica. Sin embargo, los usuarios no respondieron bien a los mapas existentes y el grupo de prueba se confundió”. Puedes incluir esta información en una o varias secciones y titularla como “Cálculo de efectos” o “Control” y “Medidas”. En uno o más párrafos, debes explicar cómo te asegurarás de que tu producto o proyecto funcione correctamente y cumpla con tus objetivos. Además, debes describir cómo vas a comprobar la existencia de errores o problemas.  Debes incluir los procesos analíticos específicos o las tecnologías que vas a emplear. Puedes mencionar algo como lo siguiente: “Vamos a comparar los tiempos de ruta proyectados con los tiempos de ruta reales para asegurarnos de que los autobuses lleguen a tiempo. Además, se llevará a cabo una encuesta a los pasajeros para evaluar su nivel de satisfacción e identificar problemas con el sistema”. Escribe “Seguridad y privacidad” en el encabezado. Luego, explica cómo vas a proteger a los usuarios de ataques cibernéticos. Describe brevemente los riesgos y cómo vas a proteger la privacidad en tu sistema. Debes redactar un par de párrafos para explicar tus métodos.  Siempre existirán riesgos o surgirán inquietudes, así que evita mencionar que “no existen riesgos” en esta sección. Puedes escribir lo siguiente: “Los usuarios deberán ingresar su ubicación y las direcciones. Además, contarán con la opción de crear un perfil y guardar sus viajes. Para proteger sus datos, se incluirá un proceso de codificación y un cortafuegos”. Un cronograma ayuda a mantener el proyecto en marcha, ya que indica tanto al cliente como a tu equipo lo que deben hacer. Puedes titular esta sección como “Cronograma” y luego desglosar las tareas de acuerdo a quién las esté realizando. Incluye una lista de viñetas para cada equipo o miembro del equipo, de acuerdo a tus preferencias.  Por ejemplo, el desglose de tareas puede incluir los títulos “Equipo de ingeniería”, “Equipo de planificación”, “Marketing” y “Control de calidad”. La lista de viñetas para el equipo de ingeniería puede incluir las siguientes tareas: “1) escribir actualizaciones de la página web, 2) escribir aplicaciones de planificación de viajes, 3) escribir sistemas de contactos.
Drafting a Tech Spec