diff options
Diffstat (limited to '.html/dev/webapp-versions.html')
| -rw-r--r-- | .html/dev/webapp-versions.html | 111 |
1 files changed, 111 insertions, 0 deletions
diff --git a/.html/dev/webapp-versions.html b/.html/dev/webapp-versions.html new file mode 100644 index 0000000..0a39463 --- /dev/null +++ b/.html/dev/webapp-versions.html @@ -0,0 +1,111 @@ +<!DOCTYPE html> +<html> +<head> + <title> + The Codex » + Semver Is Wrong For Web Applications + </title> + + <link + rel='stylesheet' + type='text/css' + href='http://fonts.googleapis.com/css?family=Buenard:400,700&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="./">dev</a> + + </li> + + <li class="crumb-2 last"> + + webapp-versions + + </li> + + </ol> + + + + <div id="article"> + <h1 id="semver-is-wrong-for-web-applications">Semver Is Wrong For Web Applications</h1> +<p><a href="http://semver.org">Semantic Versioning</a> (“Semver”) is a great idea, not least +because it's more of a codification of existing practice than a totally novel +approach to versioning. However, I think it's wrong for web applications.</p> +<p>Modern web applications tend to be either totally stagnant - in which case +versioning is irrelevant - or continuously upgraded. Users have no, or very +little, choice as to which version to run: either they run the version currently +on the site, or no version at all. Without the flexibility to choose to run a +specific version, Semver's categorization of versions by what compatibility +guarantees they offer is at best misleading and at worst irrelevant and +insulting.</p> +<p>Web applications must still be <em>versioned</em>; internal users and operators must be +able to trace behavioural changes through to deployments and backwards from +there to <a href="commit-messages">code changes</a>. The continuous and incremental nature +of most web development suggests that a simple, ordered version identifier may +be more appropriate: a <a href="builds">build</a> serial number, or a version <em>date</em>, or +otherwise.</p> +<p>There are <em>parts</em> of web applications that should be semantically versioned: as +the Semver spec says, “Once you identify your public API, you communicate +changes to it with specific increments to your version number,” and this remains +true on the web: whether you choose to support multiple API versions +simultaneously, or to discard all but the latest API version, a semantic version +number can be a helpful communication tool <em>about that API</em>.</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/dev/webapp-versions.md">See this page on Bitbucket</a> (<a href="https://bitbucket.org/ojacobson/grimoire.ca/history-node/master/wiki/dev/webapp-versions.md">history</a>). + + </p> + </div> + +</div> +</body> +</html>
\ No newline at end of file |