Documentation should mention side effects of updates on other collections
Some updates in collections may affect related information in other collections: for example, a POST on RawSourcecode may delete comments or annotations corresponding to the affected code.
It can be considered normal (the following comment was posted by @gmouchard in https://gitlab.ow2.org/decoder/frontend/-/issues/25#note_72182 ):
"Every time a raw source code gets updated, related source code (AST), comments, and annotations are automatically invalidated in the PKM. It's not a PKM bug. This behavior has always existed and it aims to ensure coherency between source code files and their abstract representations. The tools that are able to create these artefacts should be run again so that they get properly recreated: javaparser for Java, Frama-C parser for C, and Frama-Clang for C++."
This should be documented, along with specific details in OpenApi yaml doc (for each update, list of what is really updated - so the caller knows what she does when posting stuff).