| 
									
										
										
										
											2014-10-26 14:54:36 +00:00
										 |  |  |  | # README
 | 
					
						
							|  |  |  |  | Homebrew installs the stuff you need that Apple didn’t. | 
					
						
							|  |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2015-12-06 22:18:16 +00:00
										 |  |  |  | - [Install Homebrew](Installation.md) | 
					
						
							|  |  |  |  | - [Frequently Asked Questions](FAQ.md) | 
					
						
							|  |  |  |  | - [Tips and Tricks](Tips-N'-Tricks.md) | 
					
						
							|  |  |  |  | - [Gems, Eggs and Perl Modules](Gems,-Eggs-and-Perl-Modules.md) | 
					
						
							|  |  |  |  | - [Homebrew and Python](Homebrew-and-Python.md) | 
					
						
							| 
									
										
										
										
											2014-10-26 14:54:36 +00:00
										 |  |  |  | 
 | 
					
						
							|  |  |  |  | Please note: Homebrew is not 1.0 yet. Generally it works well, but when | 
					
						
							| 
									
										
										
										
											2015-12-06 22:18:16 +00:00
										 |  |  |  | it doesn’t we’d hope you report the bug. | 
					
						
							| 
									
										
										
										
											2014-10-26 14:54:36 +00:00
										 |  |  |  | ## Troubleshooting
 | 
					
						
							| 
									
										
										
										
											2015-12-06 22:18:16 +00:00
										 |  |  |  | First, please run `brew update` (twice) and `brew doctor`. | 
					
						
							| 
									
										
										
										
											2014-10-26 14:54:36 +00:00
										 |  |  |  | 
 | 
					
						
							|  |  |  |  | Second, please read the [Troubleshooting Checklist](Troubleshooting.md). | 
					
						
							|  |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2015-12-06 22:18:16 +00:00
										 |  |  |  | **If you don’t follow these steps it will take us far longer to help you with | 
					
						
							| 
									
										
										
										
											2014-10-26 14:54:36 +00:00
										 |  |  |  | your problem.** | 
					
						
							|  |  |  |  | 
 | 
					
						
							|  |  |  |  | However! Fixing build issues is easier than you think: try | 
					
						
							|  |  |  |  | `brew edit $FORMULA` and see how you fare. | 
					
						
							|  |  |  |  | 
 | 
					
						
							|  |  |  |  | ## Contributing
 | 
					
						
							| 
									
										
										
										
											2015-12-06 22:18:16 +00:00
										 |  |  |  | Read [CONTRIBUTING.md](/CONTRIBUTING.md). | 
					
						
							| 
									
										
										
										
											2014-10-26 14:54:36 +00:00
										 |  |  |  | 
 | 
					
						
							|  |  |  |  | ### Community Forums
 | 
					
						
							| 
									
										
										
										
											2015-12-06 22:18:16 +00:00
										 |  |  |  | -  [@MacHomebrew](https://twitter.com/MacHomebrew) | 
					
						
							|  |  |  |  | -  [homebrew@librelist.com](mailto:homebrew@librelist.com) ([archive](http://librelist.com/browser/homebrew)) | 
					
						
							|  |  |  |  | -  [freenode.net\#machomebrew](irc://irc.freenode.net/#machomebrew) | 
					
						
							| 
									
										
										
										
											2014-10-26 14:54:36 +00:00
										 |  |  |  | 
 | 
					
						
							|  |  |  |  | ## Supporters
 | 
					
						
							|  |  |  |  | [A list of the awesome people who gave £5 or more to our | 
					
						
							|  |  |  |  | Kickstarter](https://github.com/Homebrew/homebrew/blob/master/SUPPORTERS.md). |