arXivDaily arXiv每日学术速递 周一至周五更新
arXiv周末暂无论文更新,休息一下吧,周末愉快~~
arXiv 2009.04166cs.CYhep-ex
收藏

Belle II的用户文档和培训

User documentation and training at Belle II

Sam Cunliffe, Ilya Komarov, Thomas Kuhr, Martin Ritter, Francesco Tenchini

摘要:

Belle II是一个快速发展的合作组织,成员来自全球119个研究所。实验的软件开发团队以及软件用户非常分散。再加上软件的积极开发,这种分散化使得用户采用最新的软件版本成为一项必不可少但相当具有挑战性的任务。为了确保文档的相关性,我们采用了代码内文档的策略,并配置了一个网站,使我们能够将文档与给定的版本绑定在一起。为了防止教程变得过时,我们用单元测试来覆盖它们。对于用户支持,我们使用问答服务,不仅减少了相同问题的重复,而且还成为专家之间讨论的地方。已经开发了一个用于不同文件来源的元数据引擎原型。为了培训新用户,我们组织了集中的StarterKit研讨会,并附在合作会议上。讲习班的材料后来用于自学和组织当地培训班。

英文摘要:

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.

机构、总结、中文摘要均由AI分析而来,可能存在错误,请以论文正文为准。

↑