<div dir="ltr">I agree with having the documentation available inside of a .roswiki file. I like the suggestion about gamification of tutorial contributions/wiki maintenance. But I do not like it enough to implement it myself, so I guess I don't like it that much. <div><br></div><div>I'd like to add that it's not the quality or decay of tutorials/documentation on the wiki that makes it bad in my perspective, it's the navigation of the website. Finding relative information and "picking your own adventure" to coin MPurvis is the major downside. <br><br>There is plenty of useful information available, and after 2.5 years of working with ROS I'm still finding documentation and tutorials that would've been helpful 2 years ago when starting to integrate into the community.<br><br>tl;dr improve ability to learn from website, find relevant documentation easier<br><br></div></div><div class="gmail_extra"><br><div class="gmail_quote">On Mon, Nov 24, 2014 at 10:18 AM, Jonathan Bohren <span dir="ltr"><<a href="mailto:jonathan.bohren@gmail.com" target="_blank">jonathan.bohren@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div class="gmail_quote"><span class="">On Mon Nov 24 2014 at 3:38:46 AM Miquel Massot Campos <<a href="mailto:miquel.massot@gmail.com" target="_blank">miquel.massot@gmail.com</a>> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div>In my opinion, maintaining a repo and the documentation in two different sites is a bit confusing. One often makes changes to the repository without remembering how the roswiki entry was done, thus breaking the completeness or correctness of it. As most of us are developing on GitHub, would it make sense to have a document in each of our repositories "<i>something.roswiki"</i> so that the documentation generator<span style="font-size:13.6000003814697px"> </span></div></div></blockquote><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div>pastes it into the roswiki?<span style="font-size:13.6000003814697px"> </span></div></div></blockquote><div> </div></span><div><span style="font-size:13.6000003814697px">I agree. The wiki is broken, and package documentation should reside in the packages wherever the code is hosted.</span></div><div><span style="font-size:13.6000003814697px"><br></span></div><div><span style="font-size:13.6000003814697px">Unfortunately, as Dirk said, "</span><span style="font-size:13.6000003814697px;line-height:15.8399991989136px">whatever change you propose must be implemented by someone."</span><span style="font-size:13.6000003814697px">  So, I'm asking directly:</span></div><div><span style="font-size:13.6000003814697px"><br></span></div><div><span style="font-size:13.6000003814697px">What resources does OSRF have to re-work the ROS wiki pages for packages and tutorials in a way that simply aggregates documentation from package source repositories?</span></div><span class="HOEnZb"><font color="#888888"><div><br></div><div><span style="font-size:13.6000003814697px">-j</span></div></font></span></div>
<br>_______________________________________________<br>
ros-users mailing list<br>
<a href="mailto:ros-users@lists.ros.org">ros-users@lists.ros.org</a><br>
<a href="http://lists.ros.org/mailman/listinfo/ros-users" target="_blank">http://lists.ros.org/mailman/listinfo/ros-users</a><br>
<br></blockquote></div><br><br clear="all"><div><br></div>-- <br><div class="gmail_signature"><div dir="ltr"><div><br></div><div>Devon Ash</div><div><a href="<a href="http://ca.linkedin.com/pub/devon-ash/48/478/981" target="_blank">http://ca.linkedin.com/pub/devon-ash/48/478/981</a>" style="text-decoration:none;"><span style="font: 80% Arial,sans-serif; color:#0783B6;"><img src="<a href="https://static.licdn.com/scds/common/u/img/webpromo/btn_in_20x15.png" target="_blank">https://static.licdn.com/scds/common/u/img/webpromo/btn_in_20x15.png</a>" width="20" height="15" alt="View Devon Ash's LinkedIn profile" style="vertical-align:middle" border="0">View Devon Ash's profile</span></a><br></div></div></div>
</div>