documentcloud/backbone — Issue #995: Encourage Examples to include links to source code / writeups
Author: kirbysayshi
Created: 2012-02-13 17:41:21+00:00
State: open

Backbone obviously leaves a lot up to the developer, and this is partially what makes the list of examples on the documentation site and wiki page encouraging: "All of these other people figured it out, why can't I"?

But it's still tough, and frustrating to see that an app has solved a problem you're facing, and having it be nearly impossible to understand how they did it due to minified source.

It would be awesome if people contributing examples for entry in the Examples section were encouraged to provide a link to either source code, if it's available, or a writeup(s) explaining how an entry was able to get around a particular problem they faced.

I realize it's not practical to expect all source to be open, but encouraging folks to have a writeup also encourages knowledge to be shared, and this helps everyone! It could even be a point of pride: the reason for someone to be included on the examples page could be based on the quality of their writeup as well.

Any thoughts? Is this just silly?