Benjamin R. Haskell benizi

How Clojure's documentation can leapfrog other languages

Summary

I made a documentation generator that cashes in on Clojure's dynamism. See the play-cljs docs (a ClojureScript game library) for an example of its output.

The Problem

Like many of you, I've often wondered what my final regret will be on my deathbed. My best guess came to me in a dream recently. I was walking across the charred earth of an apocalyptic future world, maneuvering around the remains of the less fortunate. I was startled to find a young girl, barely holding onto her life. She murmured something to me. I asked her to repeat it, and she said more loudly: "I...wish your Clojure projects didn't have such crappy documentation."

Long story, short: I'm totally open to supporting more rubies if possible. Details follow.

Related issue: http://code.google.com/p/logstash/issues/detail?id=37

Summary:

core and stdlib ruby changes violently and without notice and without backwards compatibility. I want nothing of that.
need a cross-ruby date library that isn't part of stdlib (see previous point) and is also good.
need an easy way to use multiple cpus that is cross-ruby (threads are not it)

	#!/bin/bash

	# Example for the Docker Hub V2 API
	# Returns all images and tags associated with a Docker Hub organization account.
	# Requires 'jq': https://stedolan.github.io/jq/

	# set username, password, and organization
	UNAME=""
	UPASS=""
	ORG=""

	$ tmux attach
	protocol version mismatch (client 7, server 6)

	$ pgrep tmux
	3429
	$ /proc/3429/exe attach

	# First commit

	echo "hello" \| git hash-object -w --stdin
	git update-index --add --cacheinfo 100644 ce013625030ba8dba906f756967f9e9ca394464a hello.txt
	git write-tree
	git commit-tree aaa96c -m "First commit"
	git update-ref refs/heads/master 30b060d9a7b5e93c158642b2b6f64b2b758da40d

	# Second commit

	default['sshd']['sshd_config']['AuthenticationMethods'] = 'publickey,keyboard-interactive:pam'
	default['sshd']['sshd_config']['ChallengeResponseAuthentication'] = 'yes'
	default['sshd']['sshd_config']['PasswordAuthentication'] = 'no'