Skip to content

Instantly share code, notes, and snippets.

@JoshCheek
Created August 6, 2017 15:20
Show Gist options
  • Star 0 You must be signed in to star a gist
  • Fork 0 You must be signed in to fork a gist
  • Save JoshCheek/ed33de9543e605ee2568b6da6dbb47a8 to your computer and use it in GitHub Desktop.
Save JoshCheek/ed33de9543e605ee2568b6da6dbb47a8 to your computer and use it in GitHub Desktop.
Implementable Examples

What is an implementable example?

I'll omit generalizations and make this overly concrete as I think it will be easier to understand what I'm looking for here.

An implementable example is a small example of a programming library that uses the core ideas of of the library. Its purpose is to make the interface very explicit, so that someone can say "if I didn't have this library, how would I make the example actually work?" and then go implement their solution and see it work. This has been incredibly valuable for me in understanding the tools I use, what they are capable of, what decisions they make and why, and what their limitations are. Ideally it only takes a couple of hours to implement, and it provides a very deep intuition for how that tool works and why.

Examples:

Thre's a lot more, but hard to remember where they are, and they're not necessarily packaged up to be easy to show off as an example.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment