Document code architecture

[calexity]

@miketaylr to document the code architecture per our retro (https://github.com/webcompat/webcompat.com/wiki/Retro-from-December-2014-work-week/)

[miketaylr]

webcompat.com is a hybrid Flask/BackboneJS web app.
Flask powers the JSON API (which is a proxy of GitHub's Issues and Search API) and handles traditional MVC stuff. The view, however, is just an html page which contains the bootstrap JS for the Backbone app, and the CSS.

to document: how the form stuff works, how the API proxying happens, how we enable anonymous stuff, how our backbone apps are structured, grunt.

[miketaylr]

I'm going to move this into the Backlog. It would be nice to have™, but not something that exists in every open source project, and I think my time would be better spent on other issues.

If someone wants to ask questions and contribute these kinds of docs I'd be happy to help.

[miketaylr]

Note: @karlcow wants to make a graph of the model of how Flask communicates with GitHub. @karlcow can you file an issue? Let's do that this week.

[karlcow]

Note: @karlcow wants to make a graph of the model of how Flask communicates with GitHub. @karlcow can you file an issue? Let's do that this week.

paper trail with regards to the last comment
#1640 (comment)