[ros-users] [Discourse.ros.org] [Quality Assurance] ROS pkg quality metrics: analysing ROS wiki pages
gavanderhoorn
ros.discourse at gmail.com
Thu Apr 12 15:40:39 UTC 2018
[quote="Alami, post:2, topic:4442"]
How can this be implemented?
[/quote]
I can think of two possible approaches:
1. a MoinMoin macro/plugin that gets called each time a page is rendered
1. a stand-alone script that gets run periodically
The first would seem to incur quite some overhead on the wiki server, which iiuc already suffers.
The second could be part of a task run by the buildfarm. The output could then be placed on the `repo` or `doc` machine, a MoinMoin macro/plugin would then only need to parse the result (probably some yaml file), which would be much lighter.
Decoupling the analysis from MoinMoin would probably be a good idea anyway, as it would increase the reusability of this for ROS 2 documentation. You could say that doesn't really matter though, as the approach described above is tied to MoinMoin anyway (ClearSilver template, looking for sections in pages, etc).
A disadvantage of a task on the buildfarm would be increased load there, and the possibility of stale information being used by whatever renders the results (as the jobs would be periodic).
---
[Visit Topic](https://discourse.ros.org/t/ros-pkg-quality-metrics-analysing-ros-wiki-pages/4442/3) or reply to this email to respond.
More information about the ros-users
mailing list