Crear y editar documentos

Crear y editar documentos

Los documentos en AB Projects son páginas en Markdown con un historial completo de versiones. La creación y la edición se realizan en un panel lateral con vista previa en vivo, y cada cambio se registra para que el equipo siempre sepa qué cambió y por qué.

Crear una página

• En el área de Documentos del proyecto, inicie una nueva página. Asígnele un título, una ruta principal opcional (predeterminada en / — defina algo como onboarding para anidarla) y etiquetas opcionales.
• Escriba el cuerpo en Markdown. El editor muestra una vista previa en vivo junto al código fuente para que pueda ver el resultado representado mientras escribe.
• Guarde para publicar la página en el árbol. Se convierte en la versión 1.

Editar una página

• Abra una página y elija Editar (en el menú de acciones de la página). Se abre el mismo panel con el Markdown actual.
• Se requiere una nota de edición al editar. Antes de guardar un cambio debe introducir una nota breve que describa qué cambió — si la deja en blanco, AB Projects le pide que añada una "para que su equipo sepa qué cambió". (Las páginas nuevas no necesitan nota; las ediciones sí.)
• Al guardar se crea una nueva versión en lugar de sobrescribir — la versión anterior se conserva.

Historial de versiones y restauración

• Cada página registra un número de versión y el último editor y la hora.
• Abra Historial desde el menú de acciones de la página para ver las versiones anteriores, cada una con su nota de edición — de modo que el "porqué" de cada cambio queda registrado.
• Puede restaurar una versión anterior desde la lista del historial. Restaurar recupera ese contenido como la página actual (y queda registrado a su vez como una nueva versión).

Eliminar una página

• Eliminar está disponible en el menú de acciones de la página, situado deliberadamente aparte de Editar/Historial para que no se haga clic por accidente.
• Eliminar quita la página del árbol. Trátelo como una acción que requiere cuidado — prefiera editar o restaurar antes que eliminar cuando solo necesita cambiar el contenido.

Consejos

• Use la ruta principal para crear una estructura clara (por ejemplo engineering/runbooks) en lugar de una lista plana de páginas.
• Escriba notas de edición significativas — son lo que muestra el Historial y en lo que se apoyan los compañeros para entender un cambio sin comparar diferencias.
• Use la vista previa en vivo para comprobar el formato (encabezados, bloques de código, enlaces) antes de guardar.
• Si una edición salió mal, restaure la versión anterior desde el Historial en lugar de reescribir de memoria.

Con Markdown, vista previa en vivo, notas de edición obligatorias e historial completo con restauración, los Documentos siguen siendo fáciles de escribir y seguros de modificar.