Skip to content

Adam Keys is The Real Adam

Developer at large, expert typist

  • @twitter
  • @github
  • @linkedin
  • Hi! I’m Adam Keys.
  • The archives

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 Shorts

  • Untitled
    Do Something Syndrome: When Movement Trumps Results: I was to learn later in life that we tend to meet any new situation by reorganizing, and what a wonderful method it can be for creating the illusion of progress while producing confusion, inefficiency, and demoralization.
  • Untitled
    TIL that codemod is a (Python, target language agnostic) thing for doing large-scale find/replace refactorings in code bases, react-codemod is a tool for doing the same specifically for React APIs and idioms, based on jscodeshift for doing large-scale refactorings specifically on JS codebases. All come from Facebook. This is not at all confusing.
  • Untitled
    DeRay McKesson from January 1, 2018: "I’ve found that the people who “play all sides” eventually get played in the end. The world does not need you to pretend to be a neutral party on everything. Stand for the things & people you believe in." Wise words that are going to apply for a long while as we work through our weird, often dismal world. […]
  • Untitled
    Jessica Kerr - the future of software: complexity: “Complexity: Fight it, or fight through it, or embrace it? Yes.” On leverage, the intellectually rewarding kind of software complexity, and tackling accidental software complexity.
  • Untitled
    Craig Mod, on returning to the internet after forty days without: Strong net connection burbling up above, smartphone in hand, put the right apps on the thing and we are all Odysseuses. Except we didn’t strap ourselves to the mast of our ship, we walked straight up to those beautiful singing bird-women and handcuffed ourselves to Thelxinoe’s silken leg. […]
  • Thea Flowers - From API keys to tamper-proof encryption
    I didn’t expect Thea Flowers’ Building a stateless API proxy to end up explaining public-key cryptography and motivating JSON Web Tokens (JWT) from first principles. But it did! Great read.
  • I'm the bug
    Write about how computer programs are fun to solve and everyone can solve programming problems Run into a computer program that involves multiple black boxes in multiple computer programs you can’t look at the source code for, find good docs, or ask a human about Sometimes you’re the bug, sometimes you’re the windshield
Create a website or blog at WordPress.com