mob.html

   1 <html><head><title>repo.or.cz :: About the Mob Account</title></head>
   2 <body>
   3 <h1>About the Mob Account</h1>
   4
   5 <p>The <tt>mob</tt> account (the name a tribute to the paper
   6 <a href="http://www.dreamsongs.com/MobSoftware.html">Mob Software: The Erotic Life of Code</a>)
   7 is.a way to enable <em>anonymous push access</em> for your project.
   8 This is largely an experiment and may be scrapped in the future if
   9 it will not get widespread use, but I think it's an interesting try.
  10 The idea is to provide unmoderated <em>side</em> channel for random
  11 contributors to work on a project, coming from the same place as
  12 e.g. Wikipedia - that given enough interested people, the quality
  13 will grow rapidly and occassional "vandalism" will get fixed quickly.
  14 Of course this may not work nearly so well for software, but here
  15 we are, to give it a try.</p>
  16
  17 <h2>For Repository Admins</h2>
  18
  19 <p>How it works? First, you need to add the <tt>mob</tt> user to the
  20 list of users allowed to push in your project. <tt>mob</tt> is a
  21 keyless, passwordless user that anyone can use to push, without
  22 any special setup. <strong>But</strong> this does not mean that
  23 your project is not in the hands of raging mindless mob! The <tt>mob</tt>
  24 user has a special restriction: it can push only to an existing
  25 <tt>mob</tt> branch. This means that the second step you need to take
  26 is to create a <tt>mob</tt> branch in the repository (e.g.
  27 <code>cg branch-add mob git+ssh://repo.or.cz/srv/git/project.git#mob
  28         &amp;&amp; cg-push mob</code>). Then the <tt>mob</tt> user
  29 will be able to push to that and only that branch, and it won't be
  30 able to push whatsoever until you take the second step.</p>
  31
  32 <p>To sum it up: Anonymous pushes are allowed <em>only</em> to the <tt>mob</tt>
  33 branch and <em>only</em> if you add a <tt>mob</tt> user and do an initial
  34 pushout of the <tt>mob</tt> branch.</p>
  35
  36 <h2>For Users</h2>
  37
  38 <p>To clone the <tt>mob</tt> branch instead of the default <tt>master</tt>
  39 branch, paste <tt>#mob</tt> to the URL passed to <tt>cg-clone</tt>.</p>
  40
  41 <p><strong>Note that you are taking a huge security risk on yourself
  42         if you just blindly grab the mob branch and run it on your
  43         system.</strong></p>
  44
  45 <h2>For Developers</h2>
  46
  47 <p>Set up a remote branch to point at <tt>git+ssh://mob@repo.or.cz/srv/git/project.git#mob</tt>.
  48 Then push there. Have fun and enjoy, you are making the history!</p>
  49
  50 </body>
  51 </html>