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

  • Untitled
    Typo’d GraphQL as “GraphSQL” and was like “that’s a little on the nose there, fingers”
  • Untitled
    A nice reminder that our work is often more about storytelling than we think - Name It, and They Will Come — Overreacted
  • Untitled
    TIL, Vim hybrid absolute + relative line numbering: jeffkreeftmeijer.com/vim-numbe…
  • Untitled
    Does Clojure style still rely on writing a lot of chains of higher-order functions (with -> IIRC) or have they moved on to something else?
  • Untitled
    Sometimes software rewrites don’t fail - if you focus on escaping a local maximum for the product and customers.
  • Untitled
    Leaning into the impostor syndrome here, I did a little bit of GraphQL hacking to see how the ecosystem is coming along. Not too badly! github.com/therealad… Also, semi-literate programming 🤓🤠💪!
  • Untitled
    Stephen Anderson on The Future of Design: Computation & Complexity. Like everything else, its going to get more weird. But, the large-scale outcome remains the same - design is deciding which elements are essential and which elements to remove: The real world isn’t so simple, and often has many competing goals and constraints. As a designer, what are you […]
  • Untitled
    Since I can never remember their individual names, it’d help me a lot if all pugs were named “Puggers” from here on out. “Mugsy” would also be acceptable, but I might get them confused for bulldogs idk.
  • Untitled
    At least once a week, I wish I could go show fourteen-year-old Adam Diamonds and Pearls and Enter the Wu-Tang so that I’d have much better musical taste much earlier.
  • Coding without a computer, designing without a design
    A thing I want to try is coding offline, per se. Without a functional computer (like a tablet). Think first. Outline and sketch a solution. Maybe pseudocode it up. Then fill it in and make it work once a “real” computer is available. Related: think first, outline/sketch a solution, only use the computer once I’m ready to build. Related related: what if frame […]
Create a website or blog at WordPress.com