minor doc changes
redcarpet 3.0.0 needs a newer ruby version
add dependency graph for register swapping