¿cual es la forma de documentar un sistema en Delphi?

[rrf]

A nivel personal y con la misma preocupación que comentas tú, lo que hago es que incluyo muchos comentarios en el código:
// Esto se hace por tal cosa,
// los valores son: 1 para tal, 2 para cual, etc.

Y separo claramente (con líneas en blanco) lo que se hace en cada parte del código.

También, al inicio de una función o procedimiento, pongo un encabezado que deje claríto lo que se hace en él. Luego, dentro de esa sección o procedimiento, en cada parte voy aclarando lo que se hace.

Otro detalle es que utilizo nombres de variables y constantes que sean autoexplicativos. Por ejemplo: "Edicion_activada", "Se_inicio_busqueda", etc. Y lo mismo hago con los nombres de los procedimientos o funciones.

Al declarar variables o constantes, pongo a su lado un comentario que indique lo que hacen.

En general, por lo que he observado en el código que leo en el foro de otros miembros, todos seguimos reglas similares.

Lo que he notado en el código de otras personas es que dejan pocas líneas en blanco. Bueno, una cuestión de preferencias personales.

Hacer esto me lleva bastante tiempo y parece que no vale la pena, pero cuando llega el momento de localizar errores, hacer mejoras o modificaciones, lo comprendes todo muchísimo más rápido.

Espero te sirva.

Ramón.