<div dir="ltr"><br><div class="gmail_extra"><div class="gmail_quote">On Tue, Oct 1, 2013 at 10:54 PM, Mike Purvis <span dir="ltr"><<a href="mailto:mpurvis@clearpathrobotics.com" target="_blank">mpurvis@clearpathrobotics.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr">Discoverability of information on the ROS wiki is pretty big problem, IMO—there could almost be an entire SIG for documentation, with the objective of finding, updating, and drawing attention to resources like the regression_tests page referenced above.</div>
</blockquote><div><br></div><div>A documentation team would help, and I am happy to participate.</div><div><br></div><div>But, I do not think the ROS documentation problem can be solved without serious OSRF coordination. Until at least one core developer has documentation as the top-priority task, things will continue to become ever more murky. </div>
<div><br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div>A simple starting point could even just be a banner or something which pops up every day over the wiki with a new suggested read, eg:<br>
</div><div><div><br></div><div>- "Releasing debs of your package is easier than you think. Click here for an entry-level tutorial."</div>

<div>- "Submit your package idea for an API review, and receive suggestions from ROS experts. Click for details."</div><div>- "Did you know? The ROS community servers can build and test your packages as you make commits to them. Click for details on continuous integration."</div>


<div>- "Did you know? The roslaunch_add_file_check macro can check your package for missing launch file dependencies." </div><div>- "The best packages have great documentation. An example of this is the xxxx package."</div>


<div><br></div><div>Heck, could almost just be a twitter account.</div></div></div></blockquote></div><div><br></div><div>An excellent idea, Mike!</div><div><br></div><div>I suggest ros-users, instead of twitter. We need to get these messages out to the wider ROS community, and that's the best place to reach most of them.</div>
-- <br> joq
</div></div>