Open Source Comes to Campus/Resources: Difference between revisions

From OpenHatch wiki
Content added Content deleted
imported>Shauna
imported>Shauna
 
(71 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
- priority
- owner/assigned
- component/product
- summary/descriptor
- tags like "bite size"

=== 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