Ir al contenido
Manuales

Lineamientos de producción

Escriba para buscar un concepto, nodo o trámite.

    Alcaldía del Centro Histórico de San Salvador Documentación de trámites

    Cada proceso documentado en los manuales debe contener, en el orden que resulte más natural:

    1. Objetivo del proceso.
    2. Usuario o rol responsable.
    3. Requisitos previos.
    4. Punto exacto del menú donde inicia.
    5. Instrucciones numeradas paso a paso.
    6. Capturas de las pantallas principales.
    7. Resultado esperado y estados posibles.
    8. Errores frecuentes y forma de resolverlos.
    9. Notificaciones generadas.
    10. Etapa siguiente del trámite.
    11. Enlace o referencia al video correspondiente.

    Los capítulos nuevos usan el componente ProcDoc, que aplica esta estructura de forma consistente.

    • Mostrar desde dónde inicia la acción, incluyendo el menú, módulo o expediente.
    • Resaltar botones, campos o estados importantes sin ocultar el contexto.
    • Utilizar datos ficticios o anonimizados; nunca credenciales ni información personal real.
    • Mantener el mismo tamaño, resolución, estilo de señalización y pie de imagen.
    • Mostrar variantes cuando la pantalla cambie por estado, resultado o rol.

    Convención de nombres: [manual]_[modulo]_[proceso]_[paso]_[descripcion].png

    Ejemplo: externo_pago_tarjeta_03_confirmacion.png

    • Iniciar en el punto exacto del menú y finalizar mostrando el resultado esperado.
    • Indicar el rol o tipo de usuario utilizado.
    • Incluir narración o subtítulos; hacer visibles los clics, campos y botones.
    • Recortar tiempos de espera; evitar información real o sensible.
    • Incluir título, duración y proceso cubierto.
    • Un recorrido general corto más videos específicos para procesos macro.

    Los videos se publican en la sección Videos.

    Regla central: cada trámite debe llamar al proceso general correspondiente según su etapa. Solo se documentan dentro del trámite los requisitos, campos, reglas, excepciones o pantallas que sean particulares.

    Proceso reutilizableReferencia en el trámite
    Iniciar trámiteProceso general — iniciar
    Completar formularioFormularios
    Carga documentalCarga documental
    PagoPagos
    ObservacionesObservaciones
    NotificacionesNotificaciones
    ResoluciónResoluciones

    Ejemplo de redacción en una ficha: «Para completar esta etapa, consulte Proceso general de un trámite, sección Carga documental.»

    Este enfoque evita repetir instrucciones, reduce el costo de mantenimiento y garantiza que una actualización del proceso común se realice en un solo lugar.