In several scenarios, the system creates unreferenced documents at the bottom of the document.

These documents appear without any context or explanation, making it unclear to users where they came from, why they were created, or what they are expected to do with them. Since users are not informed or guided when these documents are created, the experience feels confusing and unpredictable.

Some scenarios that might create a unreferenced document:

The card creation after document publication could not be completed.

The document was moved to another section, but the card was not moved to the new parent.

The document path was changed.

The card change was made in the parent document when a document was published, but the parent document was a draft, and the editor displayed "discard changes."

(hm://zDnaenBn1Xv8hiFC3dcgikrjk4UzurF1aeqVWQ1TNnnLG34qo/:profile?v=bafyreigreppmjj5mwcbws2gspmjcv3kefcr3d3m3p5hnqhbaw53arav5ey&l please add potential scenarios)

All these scenarios are responding with a unreferenced document. My believe is that we need to "fix" the source first and not create a unreferenced document as a solution.

Examples:

The card creation after document publication could not be completed ➡ We communicate the user why the document couldn't be published, we give backup option or we invite him to try again later.

The document was moved to another section, but the card was not moved to the new parent ➡ This sounds like a bug to me, the card should be moved. If there is an error we communicate the user why the document couldn't be moved, we give backup option or we invite him to try again later.

From Horacio and Bea conversation in Discord:

H: Para que un documento NO SALGA en unreferenced documents, DOS cosas tienen que pasar:

la publicacion/movimiento del documento

la actualizacion del contenido del nuevo padre (puerta de entrada)

normalmente la primera cosa pasa bien, pero la segunda, por cualquier error, falla

B: Claro, entonces me das la razón, hay que trabajar en la segunda (la actualizacion del contenido del nuevo padre (puerta de entrada) y minimizar/eliminar el error, no crear el parche de unreferenced no?

H: Lo que pasa es que hay casos en el que dos podria fallar sin control nuestro, y de todas formas tenemos que gestionar el unreferenced document. pero si. tenemos que minimizar que 2 falle

y si falla, explicarlo bien