Code documentation is ideally written as close to the actual code
as possible, but compiled into a comprehensive set of documentation
that includes code from all languages in use. Here's how we intend
to do that.
We want the convenience of a client-side single-page application using our
MV* frameworkof choice, but don't want to sacrifice the SEO and UX
benefits of rendering the initial markup on the server. And while we're not
tech stack. Here's our attempt to have the best of both worlds, all the while
keeping duplication of logic or code between the front-end and back-end
worlds to a minimum.
SQLAlchemy defaults to implicitly opening a new transaction on your first
database query. If you prefer to start your transactions explicitly instead,
I've documented here my explorations in getting that to work.