Los diferentes equipos tendrán diferentes estrategias de documentación basadas en cualquier número de factores.
Aquí hay algunas cosas que encuentro útiles.
Prototipo
- ¿Por qué Google creó Android?
- Clockworkmod: ¿Dónde se puede encontrar una recuperación CWM para un Micromax Canvas Nitro A310 rooteado?
- ¿Existe una API de Quora y me permitirían usarla para desarrollar una aplicación basada en preguntas y respuestas? ¿Habría problemas de derechos de autor / patentes, etc.?
- ¿Cómo podemos implementar la cuota de batería de la aplicación para Android?
- ¿Debería cambiar de actividad cada vez que cambia de vista?
Un artefacto que no es negociable es un prototipo interactivo que se ejecuta en la plataforma del dispositivo de destino. Si comienza a escribir código significativo antes de construir un prototipo, creo que seguramente perderá el tiempo de desarrollo.
Mobile tiene consideraciones de diseño específicas: el usuario tiene una mano, no un mouse, por lo que la interfaz de usuario debe tolerar golpes muy imprecisos.
Los usuarios están en movimiento mientras usan dispositivos móviles, por lo que los flujos de trabajo deben ser lo suficientemente simples o sólidos como para poder interrumpirlos y reanudarlos.
Finalmente, estas restricciones también exigen enfoque. Especialmente teniendo en cuenta la pequeña pantalla, debe reducir cada vista a lo esencial.
Probar todo esto significa realmente interactuar con el diseño en vidrio. Puede hacerlo una vez que se haya escrito un montón de código durante algunas semanas o puede juntar un prototipo aproximado de la interacción en unas pocas horas.
Obviamente, analizará su proyecto más rápidamente si adopta el segundo enfoque.
Un prototipo completo también ayuda a alinear la ingeniería, el diseño y el liderazgo en lo que el producto final necesita hacer. Es la pieza de documentación de diseño más clara e instructiva que un desarrollador puede solicitar.
Documentación de diseño
En particular, es bueno tener una referencia de color y fuente tan pronto como se hayan finalizado las decisiones sobre estos puntos.
También es bueno documentar apariencias consistentes para botones y otros controles comunes. No quieres cuarenta estilos de botones que muten alrededor de tu proyecto.
Mientras tanto, los desarrolladores deben crear mecanismos que permitan implementar cambios a estas decisiones de manera rápida y universal. Aún mejor si los desarrolladores exponen un documento u otra interfaz que permite que el diseño cambie y pruebe rápidamente nuevos colores, copias y otros parámetros. Probablemente quiera construir esto temprano.
Documentación API
Si la aplicación se conecta a un servidor, querrá un documento que enumere los puntos finales de la API que debe alcanzar. Esto debería describir los datos esperados que envía el cliente, junto con los valores devueltos por el servidor.
Un enfoque muy agradable en esto es que el desarrollador del servidor proporcione ejemplos de uso y salida de rizos para cada punto final. Esto permite que el desarrollador del cliente entienda instantáneamente cómo debería funcionar una llamada API dada, lo que facilita mucho la depuración de comportamientos inesperados.
Hay un millón de otras cosas que puede y probablemente debería documentar, pero esas tres forman un control razonable de la cordura para enviar un producto móvil.