“Cómo” rara vez es suficiente.
- Identifique lo que su usuario quiere lograr con la función.
- Identifique qué tipo de idioma entiende su usuario, qué nivel de conocimiento previo tiene, etc.
- No empieces escribiendo “cómo”. Comience con el contexto: para qué está diseñada la característica, cuándo debe usarla el usuario, cuáles son las consecuencias (si las hay) de usarla en una situación incorrecta. Esta es su introducción, o si hay mucho que cubrir, conviértalo en un tema conceptual por derecho propio con enlaces entre ambos y el ‘cómo hacerlo’.
- Escriba su procedimiento de “cómo hacerlo”. Cuando lo estés escribiendo, hazlo (si puedes). Esto lo ayudará a hacerlo bien y no hacer suposiciones. Además, tenga en cuenta lo que sucederá si el usuario realiza una selección inadecuada o comete un error y aconseje sobre cómo salir de eso.
- Incluya enlaces a cualquier otro tema que pueda ser relevante, como características relacionadas, descripciones conceptuales, ejemplos, tutoriales, etc.
Así es como me acerco a mi trabajo y les brinda a los usuarios una comprensión mucho más completa de la función del software. Puramente ‘cómo’ solo les dice cómo hacer algo, pero si no sabían que tenían que hacerlo, ¡no sirve de nada!
- ¿Cómo uno o un equipo cumplen con éxito los compromisos / pronósticos de Scrum mientras producen código de calidad?
- ¿Cuál es la última tecnología / tendencias en pruebas de software?
- ¿Qué son las pruebas rápidas de software y cuál es la diferencia con las pruebas exploratorias?
- Alibaba registró un récord de ventas de $ 9 mil millones en un día durante su venta del Día del Soltero. ¿Qué pasos tomó para llevar a cabo operaciones tan masivas sin problemas técnicos en términos de tráfico y otras cosas?
- ¿Qué es mejor que Scrum?