Fuck it, serve the files directly.

author: Owen Jacobson <owen.jacobson@grimoire.ca> 2015-07-03 22:31:49 -0400
committer: Owen Jacobson <owen.jacobson@grimoire.ca> 2015-07-03 22:35:09 -0400
commit: 76aed6ef732de38d82245b3d674f70bab30221e5 (patch)
tree: d50e9a296d91ef8a49bcb29c3e80096f200a3c26 /.html/12factor
parent: 92f66d3e3a0996bb1fad9dc83d7e184f92673e5d (diff)
4 files changed, 417 insertions, 0 deletions
diff --git a/.html/12factor/3-config.html b/.html/12factor/3-config.html
new file mode 100644
index 0000000..a7f58cf
--- /dev/null
+++ b/.html/12factor/3-config.html
@@ -0,0 +1,106 @@
+<!DOCTYPE html>
+<html>
+<head>
+	<title>
+		The Codex » 
+		Factor 3: Config
+	</title>
+
+	<link
+		rel='stylesheet'
+		type='text/css'
+		href='http://fonts.googleapis.com/css?family=Buenard:400,700&amp;subset=latin,latin-ext'>
+	<link
+		rel="stylesheet"
+		type="text/css"
+		href="../media/css/reset.css">
+	<link
+		rel="stylesheet"
+		type="text/css"
+		href="../media/css/grimoire.css">
+</head>
+<body>
+
+<div id="shell">
+	
+		<ol id="breadcrumbs">
+			
+				<li class="crumb-0 not-last">
+					
+						<a href="../">index</a>
+					
+				</li>
+			
+				<li class="crumb-1 not-last">
+					
+						<a href="./">12factor</a>
+					
+				</li>
+			
+				<li class="crumb-2 last">
+					
+						3-config
+					
+				</li>
+			
+		</ol>
+	
+
+	
+	<div id="article">
+		<h1 id="factor-3-config">Factor 3: Config</h1>
+<p><a href="http://www.12factor.net/config">This section</a> advises using environment
+variables for everything.</p>
+<blockquote>
+<p><a href="https://twitter.com/derspiny">Owen J</a>: I think I disagree with
+12factor's conclusions on config even though I agree with the premises
+and rationale in general</p>
+<p><a href="https://twitter.com/derspiny">Owen J</a>: environment variables
+are neither exceptionally portable, exceptionally standard, nor
+exceptionally easy to manage</p>
+<p><a href="https://twitter.com/derspiny">Owen J</a>: and therefore should not be
+the exceptional configuration mechanism :)</p>
+<p><a href="https://twitter.com/wlonk">Kit L</a>: that's exactly the critique i have</p>
+</blockquote>
+<p>Frustratingly, the config section doesn't provide any guidance on sensible
+ways to <em>manage</em> environment variables. In any real-world deployment, they're
+going to have to be stored somewhere; where's appropriate? <code>.bash_profile</code>?
+<code>httpd.con</code> as <code>SetEnv</code> directives? Per-release <code>rc</code> files? <code>/etc/init.d</code>?</p>
+	</div>
+
+
+	
+<div id="comments">
+<div id="disqus_thread"></div>
+<script type="text/javascript">
+    /* * * CONFIGURATION VARIABLES: EDIT BEFORE PASTING INTO YOUR WEBPAGE * * */
+    var disqus_shortname = 'grimoire'; // required: replace example with your forum shortname
+
+    /* * * DON'T EDIT BELOW THIS LINE * * */
+    (function() {
+        var dsq = document.createElement('script'); dsq.type = 'text/javascript'; dsq.async = true;
+        dsq.src = 'http://' + disqus_shortname + '.disqus.com/embed.js';
+        (document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(dsq);
+    })();
+</script>
+<noscript>Please enable JavaScript to view the <a href="http://disqus.com/?ref_noscript">comments powered by Disqus.</a></noscript>
+<a href="http://disqus.com" class="dsq-brlink">comments powered by <span class="logo-disqus">Disqus</span></a>
+</div>
+
+
+	
+	<div id="footer">
+		<p>
+			
+				The Codex —
+			
+			Powered by <a href="http://markdoc.org/">Markdoc</a>.
+			
+<a href="https://bitbucket.org/ojacobson/grimoire.ca/src/master/wiki/12factor/3-config.md">See this page on Bitbucket</a> (<a href="https://bitbucket.org/ojacobson/grimoire.ca/history-node/master/wiki/12factor/3-config.md">history</a>).
+
+		</p>
+	</div>
+	
+</div>
+</body>
+</html>
+\ No newline at end of file
diff --git a/.html/12factor/7-port-binding.html b/.html/12factor/7-port-binding.html
new file mode 100644
index 0000000..738e1b0
--- /dev/null
+++ b/.html/12factor/7-port-binding.html
@@ -0,0 +1,124 @@
+<!DOCTYPE html>
+<html>
+<head>
+	<title>
+		The Codex » 
+		Factor 7: Port Binding
+	</title>
+
+	<link
+		rel='stylesheet'
+		type='text/css'
+		href='http://fonts.googleapis.com/css?family=Buenard:400,700&amp;subset=latin,latin-ext'>
+	<link
+		rel="stylesheet"
+		type="text/css"
+		href="../media/css/reset.css">
+	<link
+		rel="stylesheet"
+		type="text/css"
+		href="../media/css/grimoire.css">
+</head>
+<body>
+
+<div id="shell">
+	
+		<ol id="breadcrumbs">
+			
+				<li class="crumb-0 not-last">
+					
+						<a href="../">index</a>
+					
+				</li>
+			
+				<li class="crumb-1 not-last">
+					
+						<a href="./">12factor</a>
+					
+				</li>
+			
+				<li class="crumb-2 last">
+					
+						7-port-binding
+					
+				</li>
+			
+		</ol>
+	
+
+	
+	<div id="article">
+		<h1 id="factor-7-port-binding">Factor 7: Port Binding</h1>
+<p><a href="http://www.12factor.net/port-binding">This</a> is the exact point where the
+Heroku-specific features of the approach overwhelm the general features.</p>
+<p>Factor 7 is over-specific:</p>
+<ul>
+<li>
+<p>It presupposes the existence of a front-end routing layer, without providing
+  any insight into how to deploy, configure, provision, or manage one.</p>
+</li>
+<li>
+<p>It demands HTTP (by name) rather than a more flexible “any well-standardized
+  protocol,” without explaining why. (Web apps can have non-HTTP internal
+  components.)</p>
+</li>
+<li>
+<p>It dismisses the value of “pre-existing” container ecosystems that don't
+  work the way Heroku does. Have a giant, well-managed
+  <a href="http://glassfish.org">Glassfish</a> cluster that you deploy components to? TOO
+  BAD, not Heroku-like enough for these guys even though many aspects run
+  along similar philosophical lines.</p>
+</li>
+<li>
+<p>It dismisses the value of unix-as-a-container. Unix domain sockets with
+  controlled permissions? Psh, let's go through the network stack instead.
+  SysV IPC? (Yeah, I know.) Network. Pipes? Network. There's an implicit
+  exception for “intra-process” communication, but it's never really
+  identified or reasoned about.</p>
+</li>
+<li>
+<p>Have you <em>seen</em> the kinds of process control interfaces developers invent,
+  when left to their own devices? Signals and PID files are well-established
+  conventions, and smart, competent people still fuck those up all the time.
+  Command-line arguments are another frequent case of NIH stupidity. Do you
+  really want every app to have its own startup API?</p>
+</li>
+</ul>
+	</div>
+
+
+	
+<div id="comments">
+<div id="disqus_thread"></div>
+<script type="text/javascript">
+    /* * * CONFIGURATION VARIABLES: EDIT BEFORE PASTING INTO YOUR WEBPAGE * * */
+    var disqus_shortname = 'grimoire'; // required: replace example with your forum shortname
+
+    /* * * DON'T EDIT BELOW THIS LINE * * */
+    (function() {
+        var dsq = document.createElement('script'); dsq.type = 'text/javascript'; dsq.async = true;
+        dsq.src = 'http://' + disqus_shortname + '.disqus.com/embed.js';
+        (document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(dsq);
+    })();
+</script>
+<noscript>Please enable JavaScript to view the <a href="http://disqus.com/?ref_noscript">comments powered by Disqus.</a></noscript>
+<a href="http://disqus.com" class="dsq-brlink">comments powered by <span class="logo-disqus">Disqus</span></a>
+</div>
+
+
+	
+	<div id="footer">
+		<p>
+			
+				The Codex —
+			
+			Powered by <a href="http://markdoc.org/">Markdoc</a>.
+			
+<a href="https://bitbucket.org/ojacobson/grimoire.ca/src/master/wiki/12factor/7-port-binding.md">See this page on Bitbucket</a> (<a href="https://bitbucket.org/ojacobson/grimoire.ca/history-node/master/wiki/12factor/7-port-binding.md">history</a>).
+
+		</p>
+	</div>
+	
+</div>
+</body>
+</html>
+\ No newline at end of file
diff --git a/.html/12factor/_list.html b/.html/12factor/_list.html
new file mode 100644
index 0000000..3980ee1
--- /dev/null
+++ b/.html/12factor/_list.html
@@ -0,0 +1,90 @@
+<!DOCTYPE html>
+<html>
+<head>
+	<title>
+		The Codex » 
+		ls /12factor
+	</title>
+
+	<link
+		rel='stylesheet'
+		type='text/css'
+		href='http://fonts.googleapis.com/css?family=Buenard:400,700&amp;subset=latin,latin-ext'>
+	<link
+		rel="stylesheet"
+		type="text/css"
+		href="../media/css/reset.css">
+	<link
+		rel="stylesheet"
+		type="text/css"
+		href="../media/css/grimoire.css">
+</head>
+<body>
+
+<div id="shell">
+	
+		<ol id="breadcrumbs">
+			
+				<li class="crumb-0 not-last">
+					
+						<a href="../">index</a>
+					
+				</li>
+			
+				<li class="crumb-1 not-last">
+					
+						<a href="./">12factor</a>
+					
+				</li>
+			
+				<li class="crumb-2 last">
+					
+						<span class="list-crumb">list</span>
+					
+				</li>
+			
+		</ol>
+	
+
+	
+	<div id="listing">
+		<h1><code>ls /12factor</code></h1>
+
+		
+
+		
+			<div id="pages">
+				<h2>Pages</h2>
+				<ul>
+					
+						<li><a href="3-config">Factor 3: Config</a></li>
+					
+						<li><a href="7-port-binding">Factor 7: Port Binding</a></li>
+					
+				</ul>
+			</div>
+		
+
+		
+	</div>
+
+
+	
+	
+
+	
+	<div id="footer">
+		<p>
+			
+				The Codex —
+			
+			Powered by <a href="http://markdoc.org/">Markdoc</a>.
+			
+<a href="https://bitbucket.org/ojacobson/grimoire.ca/src/master/wiki/12factor">See this directory on Bitbucket</a>.
+
+		</p>
+	</div>
+	
+</div>
+</body>
+</html>
+\ No newline at end of file
diff --git a/.html/12factor/index.html b/.html/12factor/index.html
new file mode 100644
index 0000000..cb5bcc9
--- /dev/null
+++ b/.html/12factor/index.html
@@ -0,0 +1,97 @@
+<!DOCTYPE html>
+<html>
+<head>
+	<title>
+		The Codex » 
+		12-Factor Apps
+	</title>
+
+	<link
+		rel='stylesheet'
+		type='text/css'
+		href='http://fonts.googleapis.com/css?family=Buenard:400,700&amp;subset=latin,latin-ext'>
+	<link
+		rel="stylesheet"
+		type="text/css"
+		href="../media/css/reset.css">
+	<link
+		rel="stylesheet"
+		type="text/css"
+		href="../media/css/grimoire.css">
+</head>
+<body>
+
+<div id="shell">
+	
+		<ol id="breadcrumbs">
+			
+				<li class="crumb-0 not-last">
+					
+						<a href="../">index</a>
+					
+				</li>
+			
+				<li class="crumb-1 last">
+					
+						12factor
+					
+				</li>
+			
+		</ol>
+	
+
+	
+	<div id="article">
+		<h1 id="12-factor-apps">12-Factor Apps</h1>
+<p>Some folks over at <a href="http://heroku.com/">Heroku</a> wrote up their perceived best
+practices for building “software as a service”-style applications and called
+it <a href="http://www.12factor.net">The Twelve-Factor App</a>. It's a good read, and has
+lots of good advice in it.</p>
+<p>I have a few thoughts on it.</p>
+<hr>
+<ul>
+<li><a href="3-config">III. Config</a></li>
+<li><a href="7-port-binding">VII. Port Binding</a></li>
+</ul>
+<hr>
+<p>At some point around sections 6 or 7, the goodness of the advice is overtaken
+by the “be more like Heroku specifically”-ness of the advice, to the detriment
+of their point.</p>
+	</div>
+
+
+	
+<div id="comments">
+<div id="disqus_thread"></div>
+<script type="text/javascript">
+    /* * * CONFIGURATION VARIABLES: EDIT BEFORE PASTING INTO YOUR WEBPAGE * * */
+    var disqus_shortname = 'grimoire'; // required: replace example with your forum shortname
+
+    /* * * DON'T EDIT BELOW THIS LINE * * */
+    (function() {
+        var dsq = document.createElement('script'); dsq.type = 'text/javascript'; dsq.async = true;
+        dsq.src = 'http://' + disqus_shortname + '.disqus.com/embed.js';
+        (document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(dsq);
+    })();
+</script>
+<noscript>Please enable JavaScript to view the <a href="http://disqus.com/?ref_noscript">comments powered by Disqus.</a></noscript>
+<a href="http://disqus.com" class="dsq-brlink">comments powered by <span class="logo-disqus">Disqus</span></a>
+</div>
+
+
+	
+	<div id="footer">
+		<p>
+			
+				The Codex —
+			
+			Powered by <a href="http://markdoc.org/">Markdoc</a>.
+			
+<a href="https://bitbucket.org/ojacobson/grimoire.ca/src/master/wiki/12factor/index.md">See this page on Bitbucket</a> (<a href="https://bitbucket.org/ojacobson/grimoire.ca/history-node/master/wiki/12factor/index.md">history</a>).
+
+		</p>
+	</div>
+	
+</div>
+</body>
+</html>
+\ No newline at end of file
author	Owen Jacobson <owen.jacobson@grimoire.ca>	2015-07-03 22:31:49 -0400
committer	Owen Jacobson <owen.jacobson@grimoire.ca>	2015-07-03 22:35:09 -0400
commit	76aed6ef732de38d82245b3d674f70bab30221e5 (patch)
tree	d50e9a296d91ef8a49bcb29c3e80096f200a3c26 /.html/12factor
parent	92f66d3e3a0996bb1fad9dc83d7e184f92673e5d (diff)