Imágenes
A excepción de las Landings, que tienen imágenes ilustrativas, las imágenes en las guías nos sirven para mostrar gráficamente los procesos que documentamos. Debemos tener en cuenta:
- Que sean imágenes que complementen la información del texto. No están ahí para reemplazarlo, sino para brindar una experiencia visual y aportar mayor claridad.
- No incluir imágenes que tengan información que no es mencionada en el texto.
- Siempre que sea posible, incluye una breve descripción de las imágenes utilizando el texto alternativo. Este se utiliza para proporcionar información relevante sobre una imagen, y se inserta en markdown de la siguiente manera:
markdown
![texto alternativo](path de la imagen dentro del repositorio)
Casos especiales
- Si la imagen es meramente decorativa, no es necesario incluir el texto alternativo.
- En los botones, la descripción debe referirse a la acción que se ejecutará.
- No utilices imágenes de tablas, ya que los lectores de pantalla no pueden escanear el contenido.
- No uses imágenes que contengan información sensible y, de ser posible, tómalas desde usuarios de test.