Open Source Comes to Campus/Resources: Difference between revisions

From OpenHatch wiki
imported>Shauna
imported>Shauna
 
(72 intermediate revisions by 9 users not shown)
Line 1: Line 1:
  +
#REDIRECT [[Open Source Comes to Campus/Curriculum]]
__toc__
 
 
== What to expect as a staffer ==
 
 
==Laptop Setup==
 
 
See [https://openhatch.org/wiki/Open_Source_Comes_to_Campus/UMD/Laptop_setup|the laptop setup page.]
 
 
==Open Source Communication Tools==
 
 
The slides I use for this talk can be found [asdad | here]. These are modified from a version graciously provided by Jessica McKellar. There are substantial notes in the ODP file which can be viewed by going to the "Notes" tab.
 
 
* Slides 1-7 (#7 is titled 'Version Control')
 
* [[OSCTC_Resources#Version_Control_Demo | Version Control Demo]]
 
* Slide 8 (#8 is titled 'Sharing changes: diff and patch')
 
* [[OSCTC_Resources#Diff_and_Patch_Demo | Diff and Patch Demo]]
 
* Slide 9-10 (#10 is titled 'Issue Trackers')
 
* [[OSCTC_Resources#Issue_Tracker_Demo | Issue Tracker Demo]]
 
* Slide 11 (#11 is titled 'IRC')
 
* [[OSCTC_Resources#IRC_Demo | IRC Demo]]
 
* Slide 12-18
 
 
 
=== Version Control Demo ===
 
 
Go to the Wikipedia page for the host institution, e.g. http://en.wikipedia.org/wiki/Wellesley_College and http://en.wikipedia.org/w/index.php?title=Wellesley_College&action=history. The presenter of this talk will explore the page more thoroughly later.
 
 
I also suggest, while you are out of the ODP presentation, showing [https://github.com/bundestag/gesetze the German law Git repository] as an example of version control for things other than code.
 
 
=== Diff and Patch Demo ===
 
 
This demo uses the files in [https://github.com/shaunagm/OSCTC-resources/tree/master/diff_patch_demo this repository].
 
 
I have [https://github.com/shaunagm/OSCTC-resources/blob/master/diff_patch_demo/ToDoList a To Do List]! But maybe it needs editing. First, I'll make a copy to edit:
 
 
<pre>cp ToDoList new_ToDoList</pre>
 
 
Then I'll open it up and make changes to it. (Side note: make sure to explain which editor you're using and give options for those following along - emacs, vim, nano, or a GUI.)
 
 
How do I view the differences between the two?
 
 
<pre>diff -u ToDoList new_ToDoList</pre>
 
 
That's just printed to the command line, though. How do I store it in a file?
 
 
<pre>diff -u ToDoList new_ToDoList > changes.diff</pre>
 
 
I open up the file and see it contains the same stuff as was printed out before. Okay, now how do I apply these changes to the original list?
 
 
<pre>patch -p0 ToDoList < changes.diff</pre>
 
 
Note that the argument given to the patch is the file I want to modify, not the file that already has the changes.
 
 
People often ask - what does the argument "-u" given to diff mean, or the argument -p0 given to "patch"?
 
 
Well, -u tells diff to output in unified diff format. Two other formats are [http://en.wikipedia.org/wiki/Diff#Edit_script Edit script] (specified with -e) and [http://en.wikipedia.org/wiki/Diff#Context_format Context format] (specified with -c).
 
 
-p[x] is an argument which allows the user to specify how much of the given file's path needs to be matched. -p0 gives the entire file name unmodified. [http://www.gnu.org/software/diffutils/manual/html_node/patch-Directories.html#patch-Directories The documentation] has a bit more info.
 
 
=== Issue Tracker Demo ===
 
 
Pick a few random issue trackers, ideally ones which use different platforms, such as:
 
* [https://code.google.com/p/openstates/issues/list OpenStates] (google code)
 
* [https://bugzilla.gnome.org/buglist.cgi?product=bugzilla.gnome.org&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED Bugzilla's tracker for Bugzilla] (in bugzilla! ;) )
 
* [https://github.com/joyent/node/issues Node] (on Github)
 
 
Information to look for:
 
- status of bug
 
-
 
 
=== IRC Demo ===
 
 
==Introduction to the Command Line==
 
 
--link to website?--
 
 
==Introduction to Version Control==
 
 
--get text of previous talk--
 
 
==Github Demo==
 
 
--Paul--
 
 
==Ethics and History of Free Software==
 
 
--Asheesh--
 
 
==Staying Involved==
 
 
* Join our general mailing list.
 
* Join the alumni mailing list.
 
* Hang out with us on IRC.
 
* Training missions?
 
* Bug list?
 
* Meetups?
 
* Programs like GSoC and GNOME outreach.
 

Latest revision as of 21:34, 5 December 2013