Arnstein Henriksen siathalysedI

Mac OS X 10.9 Mavericks

Custom recipe to get OS X 10.9 Mavericks running from scratch, setup applications and developer environment. I use this gist to keep track of the important software and steps required to have a functioning system after a semi-annual fresh install.

Install Software

The software selected is software that is "tried and true" --- software I need after any fresh install. I often install other software not listed here, but is handled in a case-by-case basis.

Install from App Store

A Very Short Guide to Writing Guides

This is just a few thoughts on the topic of writing technical guides. This was intended for Basho's engineering team, but this may apply to open source projects in general.

Audience

It's commonly preached that the first step in writing is to identify your audience; to whom are you writing? This is the most well known, most repeated, and most overlooked step of writing in general and technical writing in particular. Take this document, for example. My audience is technical people who need to communicate technical information, and not teenagers, so I shy away from images of pop icons and memes. I use jargon and words like "identify" rather than "peep this".

Pronouns

In August 2007 a hacker found a way to expose the PHP source code on facebook.com. He retrieved two files and then emailed them to me, and I wrote about the issue:

http://techcrunch.com/2007/08/11/facebook-source-code-leaked/

It became a big deal:

http://www.techmeme.com/070812/p1#a070812p1

The two files are index.php (the homepage) and search.php (the search page)

	import groovy.swing.*
	import java.awt.*
	import javax.swing.*

	/**
	* Reads in a map of color themes, each with five hex color values, and displays them in a Swing component.
	*/

	assert args.size() == 1, 'The name or path to a file containing a themeMap script variable must be supplied on the command line'
	def themeMapFileName = args[0]

	import groovy.xml.StreamingMarkupBuilder
	import groovy.xml.XmlUtil
	import java.awt.Color

	/**
	* Reads in a map of color themes, each with five hex color values, and maps them to an iterm color preset plist file.
	*/

	assert args.size() == 1, 'The name or path to a file containing a themeMap script variable must be supplied on the command line'
	def themeMapFileName = args[0]

	<!DOCTYPE html>
	<html>
	<head>
	<meta charset="utf-8">
	<title>Micro Verificador de Teoremas</title>
	<script src="http://code.jquery.com/jquery-1.7.2.min.js"></script>
	<script>
	function MicroVerificador(reglas, consultas) {
	var w = ["siempre_que", "no", "y", "o", "implica_que", "cierto", "falso", "(", ")"];
	var clear = function(s){

	<?php

	/**
	* @file
	* Default theme implementation to display a block.
	*
	* Available variables:
	* - $block->subject: Block title.
	* - $content: Block content.
	* - $block->module: Module that generated the block.

	import java.io.BufferedInputStream;
	import java.io.File;
	import java.io.FileInputStream;
	import java.io.IOException;
	import java.io.InputStream;
	import java.io.OutputStream;
	import java.util.Date;
	import java.util.Properties;
	import java.util.Timer;
	import java.util.TimerTask;

	;; http://lispyscript.com
	;; LispyScript example using nodejs, expressjs and twitter bootstrap
	;; LispyScript templates are written in LispyScript!
	;; Html5 templates support all html5 tags

	;; The express server

	(var express (require "express"))
	(var app (express))
	(app.listen 3000)

	"=== Colors ==="
	colorscheme andrewmaxwell-1

	syntax on

	set number " Show line numbers
	set cursorline " Highlight the currently selected line
	set undolevels=1000 " Set undo amount to 1000
	set ignorecase " Enable case insenstive search
	set ruler " show current position at bottom