Karthik Krishnamurthy kkrs

Whether you're trying to give back to the open source community or collaborating on your own projects, knowing how to properly fork and generate pull requests is essential. Unfortunately, it's quite easy to make mistakes or not know what you should do when you're initially learning the process. I know that I certainly had considerable initial trouble with it, and I found a lot of the information on GitHub and around the internet to be rather piecemeal and incomplete - part of the process described here, another there, common hangups in a different place, and so on.

In an attempt to coallate this information for myself and others, this short tutorial is what I've found to be fairly standard procedure for creating a fork, doing your work, issuing a pull request, and merging that pull request back into the original project.

Creating a Fork

Just head over to the GitHub page and click the "Fork" button. It's just that simple. Once you've done that, you can use your favorite git client to clone your repo or j

Markdown and reStructuredText

GitHub supports several lightweight markup languages for documentation; the most popular ones (generally, not just at GitHub) are Markdown and reStructuredText. Markdown is sometimes considered easier to use, and is often preferred when the purpose is simply to generate HTML. On the other hand, reStructuredText is more extensible and powerful, with native support (not just embedded HTML) for tables, as well as things like automatic generation of tables of contents.

	# first:
	lsbom -f -l -s -pf /var/db/receipts/org.nodejs.pkg.bom \| while read f; do sudo rm /usr/local/${f}; done
	sudo rm -rf /usr/local/lib/node /usr/local/lib/node_modules /var/db/receipts/org.nodejs.*

	# To recap, the best way (I've found) to completely uninstall node + npm is to do the following:

	# go to /usr/local/lib and delete any node and node_modules
	cd /usr/local/lib
	sudo rm -rf node*

	import scala.concurrent.duration._
	import scala.concurrent.ExecutionContext
	import scala.concurrent.Future
	import akka.pattern.after
	import akka.actor.Scheduler

	/**
	* Given an operation that produces a T, returns a Future containing the result of T, unless an exception is thrown,
	* in which case the operation will be retried after _delay_ time, if there are more possible retries, which is configured through
	* the _retries_ parameter. If the operation does not succeed and there is no retries left, the resulting Future will contain the last failure.

	import com.twitter.finagle.http.path._
	import com.twitter.finagle.http.service.RoutingService
	import com.twitter.finagle.http.{Request, Response, RichHttp, Http}
	import com.twitter.finagle.{Service, SimpleFilter}
	import org.jboss.netty.handler.codec.http._
	import org.jboss.netty.handler.codec.http.HttpResponseStatus._
	import org.jboss.netty.handler.codec.http.HttpVersion.HTTP_1_1
	import org.jboss.netty.buffer.ChannelBuffers.copiedBuffer
	import org.jboss.netty.util.CharsetUtil.UTF_8
	import com.twitter.util.Future

	Latency Comparison Numbers (~2012)
	----------------------------------
	L1 cache reference 0.5 ns
	Branch mispredict 5 ns
	L2 cache reference 7 ns 14x L1 cache
	Mutex lock/unlock 25 ns
	Main memory reference 100 ns 20x L2 cache, 200x L1 cache
	Compress 1K bytes with Zippy 3,000 ns 3 us
	Send 1K bytes over 1 Gbps network 10,000 ns 10 us
	Read 4K randomly from SSD* 150,000 ns 150 us ~1GB/sec SSD