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
    Current obsession: the Porsche 962 racecar. A spacecar GT/LeMans design. Bubble-esque cockpit, ground-effect body. It won some races. A great shape with the body panels on or off.
  • Personal choices outperform technology choices
    This dinger at the end of Mattt’s WWDC wrap-up is everything: Taking care of yourself — sleeping enough, eating right, exercising regularly — will do more to improve your productivity than any language or framework out there. Your ability to communicate and collaborate with others will always be a better predictor of success than your choice of technology st […]
  • Untitled
    Data, it turns out, is far more valuable than code. Google and Facebook are unprecedented in economic history because of the data they’ve amassed; their applications, languages, and vast infrastructure merely enable the data. When the db is the interface – Jessitron: “There are two huge sources of inertia in software: data, and interfaces.” Therefore, it mak […]
  • 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.
Create a website or blog at WordPress.com