[ros-users] [Discourse.ros.org] [Quality Assurance] ROS pkg quality metrics: analysing ROS wiki pages

gavanderhoorn ros.discourse at gmail.com
Fri Apr 13 09:19:05 UTC 2018

[quote="tfoote, post:7, topic:4442"]
the wiki is designed to be easily and openly edited without significant structure

One of the ideas is that prescribing structure (ie: freedom *from* choice) would to improved readability and usability of the wiki (this is already done with the *Package Links* box and the *Package Header*). As you're probably aware, structure helps as it allows visitors to form habits (ie: quickly assess state of something as it's easy to compare to others).

An added benefit of prescribing structure is that it makes analysis easier/possible. And with analysis comes the possibility for gamification, which is something that appears to work well for/in other projects/contexts.

[quote="tfoote, post:7, topic:4442"]
It might be worth exploring auto generating more of the content, rather than finding way to enforce that the content is captured in the free form wiki content.

Auto-generation would certainly help, but as I wrote above, enforcing some minimal content might be equally as effective.

[Visit Topic](https://discourse.ros.org/t/ros-pkg-quality-metrics-analysing-ros-wiki-pages/4442/8) or reply to this email to respond.

More information about the ros-users mailing list