Skip to content

The Real Adam

Developer at large, expert typist

  • @twitter
  • @github
  • @linkedin
  • About
    • Projects
    • Principles
    • Contact
  • Archives
  • The Playlist

Making the pretty docs

Adam Keys Code, Curated March 18, 2009 0 Minutes

When you really need to generate nice technical documentation, you would be wise to walk in Assaf Arkin’s footsteps.

Share this with your friends:

  • Twitter
  • Reddit
  • Tumblr
  • Facebook
  • Tagged
  • ruby

Published by Adam Keys

Telling a joke. Typing. View all posts by Adam Keys

Published March 18, 2009

Post navigation

Previous Post A few promising Ruby libraries
Next Post On feeds: application posture

Find some deep cuts

Put it in your feeds

RSS Feed RSS - Posts

RSS Shorts

  • Little (Rust) learning victories
    I’m attempting to learn Rust. And really make it stick this time around. A lot of the “making it stick” part is making lists and having the discipline to stick with crossing items off them! A smaller part is figuring out how I can notch very small victories no matter how much progress I make. This is crucial because I’ve got about a half an hour each morning […]
  • Untitled
    Was way more into this playlist when I thought it was “Eels!”
  • Pardon the dust, learning in progress
    I’m trying a few things while I learn how ray-tracers work: learning Rust and graphics programming collecting my thoughts and discoveries in the repo, aka blogging doing it all in public, rather than a private repo tackling very math-y programming and domain problems, despite my lack of acumen in the area Brought to you by: more folks should do blogging-like […]
  • Untitled
    It’s true that Twitter took some air out of blogging. I suspect it’s also true that they formed a positive feedback loop when they overlapped. Longer-form writing informed tweets, tweets responded to or inspired longer-form writing. We can have our tweets and eat blogs too!
  • Untitled
    Listening to a DJ live set and it opens with the whitest, most English version of a 90’s hip-hop sketch I’ve ever heard. This person learned the exactly wrong lesson of possibly every album after 3 Feet High and Rising.
  • Untitled
    Gil! Scott! Heron! man crush on LCD Soundsystem intensifies itunes.apple.com/us/album/…
  • Untitled
    Why blogs are still lovely, part fourteen: shawnblanc.net/2019/01/s…
  • Untitled
    Corollaries to “new languages won’t achieve career-sustaining critical mass”: 1) frameworks become the important point of leverage 2) framework/language harmony or outright integration ala Elm or Erlang become even more important.
  • Untitled
    Long bet: Java, PHP, JavaScript, Python, Ruby, and C# will be the last languages that achieve a critical mass such that they can sustain developers through their whole career. From here on out, it’s a melting pot of framework and technology choices.
  • Untitled
    Increasingly convinced houses only exist in two states: brand new and invisibly needing repair, lived in and visibly needing multiple repairs. This adage may apply to societies too.
Create a website or blog at WordPress.com