Guideline 12
Documentation
Researchers document all information relevant to the production of a research result as clearly as is required by and is appropriate for the relevant subject area to allow the result to be reviewed and assessed. In general, this also includes documenting individual results that do not support the research hypothesis. The selection of results must be avoided. Where subject-specific recommendations exist for review and assessment, researchers create documentation in accordance with these guidelines. If the documentation does not satisfy these requirements, the constraints and the reasons for them are clearly explained. Documentation and research results must not be manipulated; they are protected as effectively as possible against manipulation.
Explanations:
An important basis for enabling replication is to make available the information necessary to understand the research (including the research data used or generated, the methodological, evaluation and analytical steps taken, and, if relevant, the development of the hypothesis), to ensure that citations are clear, and, as far as possible, to enable third parties to access this information. Where research software is being developed, the source code is documented.
Comments - General (4)
Notes on documentation when using computer-assisted algorithmic or data-driven procedures in research
03.12.2020 – A description of the extent of documentation to be expected when using computerised algorithmic or data-driven processes, including tracking processes or machine learning, is provided.
Comment on: GL11 (General) , GL12 (General)
Maintaining storage capacity
03.12.2020 – Long-term storage of research data
Comment on: GL7 (General) , GL11 (General) , GL12 (General) , GL13 (General) , GL17 (General)
Research software documentation
03.12.2020 – Reproducibility is another important issue in connection with research software. In addition to the source code as mentioned in the explanations (Level 2), it is also important to document and archive the design of the software, and where applicable the ...
Comment on: GL12 (General)
Documentation of results that do not support a hypothesis
03.12.2020 – The non-confirmation of a hypothesis is also a scientific accomplishment that contributes to gaining knowledge.
Comment on: GL12 (General)