Differences between revisions 4 and 5
Revision 4 as of 2013-01-15 18:45:35
Size: 3471
Comment:
Revision 5 as of 2013-01-15 19:44:44
Size: 1070
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
SVN Walk-through Directory = SVN Walk-through Directory -- UNIX =
Here you find simple walkthroughs for all things SVN on Unix. There are also [[walkthroughDirectoryWindows|Windows]] and [[walkthroughMac|Mac]] walkthrough directories.
Line 3: Line 4:
[[Concept|walkthroughDirectoryConcept]] === Programmming environments ===
 . [[walkthroughUnixC|C]], [[walkthroughUnixC++|C++]], [[walkthroughUnixJava|java]], [[walkthroughUnixML|ML]],[[walkthroughUnixOctave|Octave]]
Line 5: Line 7:
[[Walkthrough Directory Project Page| walkthroughDirectoryProjectPage]] === Documenting envinronments: ===
 . [[walkthroughUnixWebsite|Websites]], [[walkthroughUnixManuals|Manuals]],
Line 7: Line 10:
----------
A directory of walkthroughs by user goals:
 . (what else?)
Line 10: Line 12:
The quality benchmark of usefulness is that the admin can phone in sick and get the apprentice(or the PHB) to fix whatever problem occurs with minimal phone support, using those walkthroughs. === Office environments: ===
 . [[walkthroughUnixAccounting|Accounting]],(spreadsheets?) [[walkthroughUnixFormletters|Formletters]], [[walkthroughUnixBrochures|Brochures]],
Line 12: Line 15:
The other goal is to set people of every kind of skill level up as quickly as possible and to make it easy to get started and start being productive, without requiring them to read too much or learn things they do not need to know. If we can get the initial time investment down to 60 minutes or less, that would be great.  . (why does (say) gnumeric not have an SVN dialog plugin?)
Line 14: Line 17:
The walkthroughs are categorised by OS, windows users do not need to know unix cmds and vice versa; then split those into useage categories -- someone who maintains a website will have different needs than a software house, or someone who is using svn as an audit trail or backup device. === Creative collaborative environments: ===
 . [[walkthroughUnixBook|Writing/editing a book]], [[walkthroughUnixPaper|writing/editing a scientific paper]]
Line 16: Line 20:
Sub categories and their individual templates: === Class room uses: ===
 . [[walkthroughUnixAudittrail|audittrail]] facilitate groupwork and produce an audit trail
Line 18: Line 23:
a) programmming environment:

 . Is listing by languages/mixed env useful here?
  . ie, does a (say) C shop have different needs to a place that uses ML

b) documenting envinronments:

 . websites Manuals (what else?)

c) office environments:

 . accounting (spreadsheets) forms/ boilerplate letter repository (why does (say) gnumeric not have an SVN dialog plugin?)

d) creative collaborative environments:

 . writing/editing a book writing/editing a scientific paper

e) class room uses:

 . audit trail for group work, so you can see which student contributed what.

e) Other uses that currently elude me.

It's easy to add new categories and we can probably rope users into writing the walkthroughs for us, with only minimal editing on our part. I know people keep a plethora of differnt walkthroughs on their web pages, but it's best to strive for 'information supremacy'(a not quite monopoly I mean) here, since we're 'the horses mouth' (so to speak), we should be the first address and also, in a way it is part of the marketing that convinces people to use svn who until now had not considered that it would be useful to them.

Aside questions:

How about offering a script to make a typical svn directory that is useful for their application? If they will take our advice about the trunk set up, why not save their time with a script? It also neatly serves to standardise svn usage.

Also offer poster type print out of the following for pinning on the wall (plus of course, the website page):

General Walkthrough template:

----------
OS used:

Application of walkthrough(short desc):

general description of typical workflow for users' particular application(long desc):

downloading/installing:

creating a repository:

your first commit:

your first checkout:

subsequent commmits:

subsequent checkouts:

Now you're done with the set-up, here are the most frequently used commands:

reverting your work:

making a patch:

applying a patch:

removing a patch:

using a patch to communicate about code:

looking at a snapshot from date x.y.z:

copying out a snapshot from date x.y.z:

Seeking and finding things:

 . (example scenario: can't remember when, but recalls quirky unique typo that could be search for.)

seeing the list of changes:

by time, by user, by section

seeing who changed/created what:
=== Other uses: ===

SVN Walk-through Directory -- UNIX

Here you find simple walkthroughs for all things SVN on Unix. There are also Windows and Mac walkthrough directories.

Programmming environments

Documenting envinronments:

Office environments:

Creative collaborative environments:

Class room uses:

  • audittrail facilitate groupwork and produce an audit trail

Other uses:

walkthroughDirectory (last edited 2013-01-15 19:44:44 by GabrielaGibson)