Rucio is a software framework that provides functionality to organize, manage, and access large volumes of scientific data using customisable policies. The data can be spread across globally distributed locations and across heterogeneous data centers, uniting different storage and network technologies as a single federated entity. Rucio offers advanced features such as distributed data recovery or adaptive replication, and is highly scalable, modular, and extensible. Rucio has been originally developed to meet the requirements of the high-energy physics experiment ATLAS, and is continuously extended to support LHC experiments and other diverse scientific communities. For example, the ATLAS experiment orchestrated an Exabyte of data transfer and processing and is growing rapidly.
The current documentation is available from multiple places and in different formats, including scientific articles, readthedocs.io with source in the code, Google Drive, Github, DockerHub, or Wikis. This dispersion and diversity makes it difficult to pinpoint information and to recognise which information is outdated or superseded, wrong, or simply lacking in detail. Especially in Wikis the information is usually directed towards a single experiment instance of Rucio, however the underlying concepts can be applicable to multiple different instances. With this proposal we aim to consolidate and automate the documentation as much as possible. We believe that the best documentation is the one which can be generated from the code itself. In addition the manually written documentation, e.g. setup and tutorials, should also be brought into a single format from which it can be distributed automatically.