Go to Post The few people who don't ever make mistakes are the same people who simply don't do anything. What people do after they make a mistake tells others what they are made of. - Andy Baker [more]
Home
Go Back   Chief Delphi > FIRST > General Forum
CD-Media   CD-Spy  
portal register members calendar search Today's Posts Mark Forums Read FAQ rules

 
 
 
Thread Tools Rating: Thread Rating: 3 votes, 5.00 average. Display Modes
Prev Previous Post   Next Post Next
  #1   Spotlight this post!  
Unread 31-12-2014, 16:19
JesseK's Avatar
JesseK JesseK is offline
Expert Flybot Crasher
FRC #1885 (ILITE)
Team Role: Mentor
 
Join Date: Mar 2007
Rookie Year: 2005
Location: Reston, VA
Posts: 3,661
JesseK has a reputation beyond reputeJesseK has a reputation beyond reputeJesseK has a reputation beyond reputeJesseK has a reputation beyond reputeJesseK has a reputation beyond reputeJesseK has a reputation beyond reputeJesseK has a reputation beyond reputeJesseK has a reputation beyond reputeJesseK has a reputation beyond reputeJesseK has a reputation beyond reputeJesseK has a reputation beyond repute
"Whitepaper" Etiquette, 2015 Edition

I hope to release an interactive tool called EtherSim tomorrow* with associated actual whitepaper, yet I'm worried that it will simply get lost in the new noise of "whitepapers". Perhaps a there could be a new section of CD called "open source designs", but in the meantime I think we need to talk about some etiquette for Whitepapers. Teams releasing source code or "designs" (in whatever form) as part of the new <R13> preview can really detract from the actual white papers that have some facts, discussions and analysis rather than being a zip file. This noise has a small but compounding impact on overall competitiveness of new teams.

Things like Beta source code releases, raw tools, etc, make sense to stay on ChiefDelphi. Many new teams come to CD first for ideas, information and examples of what to do. Yet a team's robot source code doesn't belong on CD; it belongs somewhere like GitHub. Many teams already have their own GitHub account (nicely named frc####) with public and private repositories so please feel free to search GitHub for good examples of why GitHub is so much better for hosting robot code. Discussion of the source code would then happen in the programming forums rather than the unsorted, un-categorized white paper section.

In addition, things like CAD are more appropriately hosted on a team's own website. In the very least, there are also other public places to host like Google Drive and Dropbox. A forum post or image seems most likely the best way to start discussion of particular aspects of the design on CD since there's a picture for everyone to discuss without the need of extra software. Additionally, hosting multi-megabyte zip files of CAD designs on CD simply causes more expense for CD, all just so (IMO) a team can point and say "see, we open-sourced the design".

On a final note, <R13> doesn't say a team must announce their design for the design to be open source. I don't mean this to say that most designs don't have something interesting about them or that a team shouldn't toot its own horn. Rather, I'm trying to drive home the point that the <R13> preview doesn't require a meaningless CD zip file in the whitepaper section.

*Pending some polish. It will be open-sourced on GitHub when I figure out an appropriate way to extract a library of source 1885 wants to use for other projects as well
Reply With Quote
 


Thread Tools
Display Modes Rate This Thread
Rate This Thread:

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

vB code is On
Smilies are On
[IMG] code is On
HTML code is Off
Forum Jump


All times are GMT -5. The time now is 05:46.

The Chief Delphi Forums are sponsored by Innovation First International, Inc.


Powered by vBulletin® Version 3.6.4
Copyright ©2000 - 2017, Jelsoft Enterprises Ltd.
Copyright © Chief Delphi