Belle II is a rapidly growing collaboration with members from one hundred and nineteen institutes spread around the globe. The software development team of the experiment, as well as the software users, are very much decentralised. Together with the active development of the software, such decentralisation makes the adoption of the latest software releases by users an essential, but quite challenging task. To ensure the relevance of the documentation, we adopted the policy of in-code documentation and configured a website that allows us to tie the documentation to given releases. To prevent tutorials from becoming outdated, we covered them by unit-tests. For the user support, we use a question and answer service that not only reduces repetition of the same questions but also turned out to be a place for discussions among the experts. A prototype of a metasearch engine for the different sources of documentation has been developed. For training of the new users, we organise centralised StarterKit workshops attached to the collaboration meetings. The materials of the workshops are later used for self-education and organisation of local training sessions.
翻译:Belle II是一个与来自全球各地119个研究所的成员迅速扩大的合作。实验软件开发团队以及软件用户非常分散。在软件的积极开发的同时,这种分散化使用户采用最新的软件释放成为一项重要但相当艰巨的任务。为了确保文件的相关性,我们采取了编码文件的政策,并配置了一个网站,使我们能够将文件与提供的文件联系起来。为了防止辅导材料过时,我们用单位测试覆盖了它们。对于用户支持,我们使用问答服务,不仅减少重复同样的问题,而且成为专家讨论的场所。已经开发了不同文件来源的元化搜索引擎原型。为了培训新用户,我们组织了与协作会议有关的集中的StarterKit讲习班。这些讲习班的材料后来被用于自我教育和组织当地培训课程。