View Single Post
  #2   Spotlight this post!  
Unread 27-07-2016, 18:50
s-neff's Avatar
s-neff s-neff is offline
Registered User
AKA: Sam
FRC #0841 (Biomechs)
Team Role: Mentor
 
Join Date: Apr 2016
Rookie Year: 2009
Location: California
Posts: 30
s-neff is a jewel in the roughs-neff is a jewel in the roughs-neff is a jewel in the roughs-neff is a jewel in the rough
Re: "Gamifying" Documentation

Quote:
Originally Posted by alecmuller
For me, the motivation is to have a library of modular robot components we can draw from on the very first day of kickoff. These components (loaders, shooters, kickers, manipulators, etc) are far more useful when they're well-documented - whether you're using them as-is or customizing the design.
I want a mechanism library. I don't know if my students want one. They seem to like Just Making Things.

Quote:
Originally Posted by ASD20 View Post
Ideally the recognition of the utility and importance of documentation is motivation enough.
Ideal worlds are for physicists...

Quote:
Having said that, I know it takes time to gain an appreciation of the value of documentation.
It takes experiencing the documentation being valuable, for appreciation to set in. "I didn't know what to do, until I found a solution in last year's documentation." Maybe when i'm in "teacher-mode", working in explicit references to "you know how to do this, you did it last year."?

Quote:
In the meantime, I would say that the best way to motivate students to document is to make it clear that it is looked highly upon when selecting team leadership. Let me be clear, this is not bribery at all because by working on documentation, students are showing many of the traits and skills needed to be a good leader. I am going to use the example of the BOM, though this also applies to other forms of documentation. I can't think of a better way to learn about every single part on the robot and what it does, than creating a spreadsheet of every single part on the robot. Writing the BOM also familiarizes you with FRC suppliers, the KOP, and the manual. It also demonstrates a lot of good leadership skills like organization, attention to detail, commitment, and being willing to do less desirable jobs for the sake of the team.
I like this carrot. Do note this is a carrot that doesn't always work for every student. It worked on me, but I am not every student.
__________________
Fun:
Mentor - Team 841 (2015 - ? )
Mentor - Team 4 (2013 - 2014)
Student - Team 192 (2009 - 2010)
Work:
SunPower Systems, Product Engineering - Utility Power Plants (2015 - ? )
BSci, Mechanical Engineering, UCLA (2010-2015)
Reply With Quote