 
<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>Bits Pushed Around</title>
	<atom:link href="http://bitspushedaround.com/feed/" rel="self" type="application/rss+xml" />
	<link>http://bitspushedaround.com</link>
	<description>A Website Made By Alex Duloz</description>
	<lastBuildDate>Mon, 18 Feb 2013 09:57:08 +0000</lastBuildDate>
	<language>en</language>
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
	<generator>http://wordpress.org/?v=3.3</generator>
		<item>
		<title>On failure, and more specifically on the Pastry Box not becoming a book</title>
		<link>http://bitspushedaround.com/on-failure-and-more-specifically-on-the-pastry-box-not-becoming-a-book/</link>
		<comments>http://bitspushedaround.com/on-failure-and-more-specifically-on-the-pastry-box-not-becoming-a-book/#comments</comments>
		<pubDate>Mon, 18 Feb 2013 09:55:46 +0000</pubDate>
		<dc:creator>alex</dc:creator>
				<category><![CDATA[Uncategorized]]></category>

		<guid isPermaLink="false">http://bitspushedaround.com/?p=180</guid>
		<description><![CDATA[So&#8230; now I know. The first season of the Pastry Box project is not going to become a book. I thought it would be interesting to document this specific juncture of the project, what I feel, and how I have taken this—let&#8217;s drop the bomb—failure. Well, I feel kind of embarrassed, that&#8217;s for sure, because [...]]]></description>
			<content:encoded><![CDATA[<p>So&#8230; now I know. The first season of the Pastry Box project is not going to become a book. I thought it would be interesting to document this specific juncture of the project, what I feel, and how I have taken this—let&#8217;s drop the bomb—failure.</p>
<p>Well, I feel kind of embarrassed, that&#8217;s for sure, because I sent many emails to the Pastry Box guests, took up their time, and it was all for nothing. I guess I don&#8217;t have to be, but I am. I&#8217;m disappointed, too: in all honesty, I thought the book would be funded in less than 48 hours. Really, I thought that&#8217;s how things would turn out. I believed that reaching my goal would be easy not due to delusions of grandeur, but because at $35 a book I would have needed approximately 500 backers to get the project rolling, which is truly <em>nothing</em> compared to the traffic the website generates on a daily basis. About that, yes, I&#8217;m disappointed. But about the project not becoming a book, about the fact that the campaign <em>failed</em> to reach its goal, no, I don&#8217;t feel bad. Oddly.</p>
<p>Here&#8217;s why, I guess.</p>
<p>Failure is a great starting point. When you have already seen many different projects fail in your life, you come to understand that failure is a source of creativity. I&#8217;m not trying to present things in any way differently to how they truly are, and nor am I attempting to hide my disappointment behind some forced, faked optimism: failure is the impossibility of seeing your intentions become reality, and it&#8217;s a very unpleasant outcome, especially since it usually means a lot of wasted time and energy. But when you look at it carefully, failure is also a very strong opportunity to find new and different ways to give those frustrated intentions a voice.</p>
<p>I realized the fundraising would not produce the desired result on the fourth day of the campaign. Many people had tweeted about the project, the Pastry Box project was receiving its usual fat load of traffic, and yet the number of people visiting <a href="https://backified.com/">Backified</a> was very low. Extremely low. And I&#8217;m not talking about people landing on the campaign and bouncing back. And I&#8217;m not talking about people registering and then getting cold feet upon seeing that their credit card would be charged immediately (in <a href="http://www.indiegogo.com/">Indiegogo fashion</a>). I&#8217;m talking about simple, bare page loads: Backified has received <em>very few</em> visits. Unsurprisingly, the Pastry Box stats showed that only a handful of people clicked on the link to the campaign (which wasn&#8217;t what you would call a discreet link).</p>
<p>So, what does this mean?</p>
<p>Simply that our users are not interested in having a book containing the texts published on the website. Please let me pompously quote what I said on that matter in a <a href="http://www.netmagazine.com/interviews/alex-duloz-pastry-box-project">.net interview dedicated to the Pastry Box project</a>:</p>
<blockquote><p>If more than one of your users requests a feature then you should try to add that feature. If readers of The Pastry Box request a book, I want that feature to have a chance to be included in the project (&#8230;) The funding campaign is a question to our audience: is the website enough or would they like us to seal its content in a paper version? I think it&#8217;s better to ask such questions through a full-fledged funding campaign rather than through a poll. At least you know where you stand. If it&#8217;s a ‘yes’, then the feature will be included (we&#8217;ll publish the book); if it&#8217;s a ‘no’, then we&#8217;ll stick to the digital version, which is quite awesome as it is. It&#8217;s worth a try, anyway.</p></blockquote>
<p>Well, my question got a kind reply: &#8220;Let&#8217;s stick to the digital version.&#8221; If I count the number of emails I received in 2012 about the Pastry Box becoming a book and the number of people who backed the project, there is almost a match. So, the readers who wanted the website to become a book did not represent a &#8220;silent mass&#8221;. People are simply fine with the website as it is. The fact that the fundraising fell short of our goal in that regard isn&#8217;t really even a failure. Indeed, the website has received rave reviews and the traffic is growing exponentially. So, the Pastry Box is what you would call a &#8220;successful&#8221; venture, and the fact that the campaign failed to achieve its goal isn&#8217;t due to the project itself. Clearly, our users are not in need of a paper version of the Pastry Box project. Period.</p>
<p>Which leaves me with my motivations for turning the website into a book. Please let me quote myself a second time here:</p>
<blockquote><p>Behind the idea of making The Pastry Box into a book lies a disturbing question: is the Internet ready to preserve content through time, through the ages? Unfortunately, the answer, at the moment, is ‘no’. (&#8230;) On a very personal level, I built The Pastry Box to be a legacy for the future, a door to a specific area of our day and age with a view to understanding it, dreaming about it, and reconstituting what it really is through details and anecdotes which, when put together, draw a precise, vivid landscape of an era, as opposed to the vague, always inaccurate myth coming times will retain. We can&#8217;t risk letting that content disappear into the abyss of digital production.</p></blockquote>
<p>Here&#8217;s the big failure, the part of the whole thing that is <em>so</em> unpleasant, the part that hurts: I find myself with a publication which has a strong concept and great content, but whose form is a complete anti-pattern: how can you at once try to document a facet of your day and age to pass to future generations <em>and</em> accept that the result of this process a) lies in a single remote location (some server), b) is tied to a database that, by its nature, breaks content into smaller, often inconsistent pieces, and c) whose availability depends on one single person not forgetting to pay the hosting bills? </p>
<p>This is <em>so</em> wrong.</p>
<p>And&#8230; that&#8217;s exactly where creativity sets in.</p>
<p>If content preservation is not going to be achieved through a book, it will be achieved through other means. Because, I mean, when you have already seen many different projects fail in your life, and you&#8217;re still creating new stuff, you come to understand that there is a <em>thing</em> inside of you that doesn&#8217;t take failure as an acceptable conclusion.</p>
<p>So, on the fourth day of the campaign, I started asking myself the following question: &#8220;Which means is going to seal the Pastry Box content more safely than just a bunch of web pages whose content is obscurely spread across a remotely hosted database?&#8221;</p>
<p>There is no perfect answer to that question—even a book wasn&#8217;t a perfect answer—but I&#8217;ve already come up with a few ideas that have kept me very busy for the past few weeks. And I&#8217;m wondering why I didn&#8217;t start with those ideas in the first place.</p>
<p>And, when you have already seen many different projects fail in your life, you come to understand that it&#8217;s a damned good sign.</p>
<p>So, all in all, failure proves once again not to be a bad thing (although it is an utterly unpleasant experience). I wish the book had got funded, but it&#8217;s more interesting that it hasn&#8217;t. It forces me to open other doors, to find workarounds. To be more creative and get out of my comfort zone.</p>
<p>For keen ears, thuds are the sound of progress. </p>
]]></content:encoded>
			<wfw:commentRss>http://bitspushedaround.com/on-failure-and-more-specifically-on-the-pastry-box-not-becoming-a-book/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
		<item>
		<title>On Being Interviewed By .net Magazine</title>
		<link>http://bitspushedaround.com/on-being-interviewed-by-net-magazine/</link>
		<comments>http://bitspushedaround.com/on-being-interviewed-by-net-magazine/#comments</comments>
		<pubDate>Mon, 28 Jan 2013 08:50:25 +0000</pubDate>
		<dc:creator>alex</dc:creator>
				<category><![CDATA[Uncategorized]]></category>

		<guid isPermaLink="false">http://bitspushedaround.com/?p=176</guid>
		<description><![CDATA[I&#8217;d like to document this wonderful moment: I&#8217;ve been interviewed by a magazine which I love. It feels great. Rewarding. Really. Don&#8217;t you ever forget that. http://www.netmagazine.com/interviews/alex-duloz-pastry-box-project]]></description>
			<content:encoded><![CDATA[<p>I&#8217;d like to document this wonderful moment: I&#8217;ve been interviewed by a magazine which I love.</p>
<p>It feels great. Rewarding. Really.</p>
<p>Don&#8217;t you ever forget that.</p>
<p><a href="http://www.netmagazine.com/interviews/alex-duloz-pastry-box-project">http://www.netmagazine.com/interviews/alex-duloz-pastry-box-project</a></p>
]]></content:encoded>
			<wfw:commentRss>http://bitspushedaround.com/on-being-interviewed-by-net-magazine/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
		<item>
		<title>On Thinking In Platforms</title>
		<link>http://bitspushedaround.com/on-thinking-in-platforms/</link>
		<comments>http://bitspushedaround.com/on-thinking-in-platforms/#comments</comments>
		<pubDate>Fri, 11 Jan 2013 16:08:05 +0000</pubDate>
		<dc:creator>alex</dc:creator>
				<category><![CDATA[Uncategorized]]></category>

		<guid isPermaLink="false">http://bitspushedaround.com/?p=160</guid>
		<description><![CDATA[Outline for a Lecture Introduction How does an idea take shape? Which ideas do we nip in the bud because we deem them as “unfeasible”? We&#8217;ll consider those “unfeasible” ideas and why they are exactly what you&#8217;re looking for. I&#8217;ll explain why &#8220;unachievable&#8221; projects carry with them an infinite stock of creativity when you start [...]]]></description>
			<content:encoded><![CDATA[<p style="font-style: italic; text-align: center">Outline for a Lecture</p>
<h4 class="h-beta">Introduction</h4>
<p>How does an idea take shape? Which ideas do we nip in the bud because we deem them as “unfeasible”? We&#8217;ll consider those “unfeasible” ideas and why they are exactly what you&#8217;re looking for. I&#8217;ll explain why &#8220;unachievable&#8221; projects carry with them an infinite stock of creativity when you start trying to answer the following question: &#8220;Which projects should I create to find myself in a position where that unfeasible project becomes feasible?&#8221;</p>
<h4 class="h-beta">Thinking in Platforms</h4>
<p>We&#8217;ll reflect on how a given project can lead to another project, which can lead to yet another project, which will eventually lead you to achieve something you thought could never be achieved, which opens even more doors. I will explain why thinking in terms of platforms is incredibly efficient and enlightening, and why this approach will get you much further than you originally expected and planned.</p>
<h4 class="h-beta">A Workflow Ethic: Avoiding the Pitfalls of Platforming</h4>
<p>Building on Frank Chimero&#8217;s <i><a href="http://acreativedose.com/2012/08/30/a-creative-workflow/">Proposed Creative Workflow</a></i>, we&#8217;ll see why you should only green-light ideas that are satisfying both as a means <em>and</em> as an end. The risk with thinking in platforms is that you’ll create projects you don&#8217;t really believe in or don&#8217;t really like just as a means of starting another project you really want to do. We&#8217;ll reflect on why you will expose yourself to failure and burnout if you follow some cold, elaborate scheme instead of your gut, and what you will be missing if you don&#8217;t follow adequate creative ethics.</p>
<h4 class="h-beta">Your Expectations, and What Your Projects Have to Say about Them</h4>
<p>In this part, we&#8217;ll talk about expectations: yours, your contributors&#8217;, your coworkers&#8217;, and, finally, your users&#8217;. We&#8217;ll expand on why you don&#8217;t actually need to establish any expectations, and how your projects will in fact take care of everything for you as long as you remain smart enough to understand their potential and the personal fulfillment they have to provide.</p>
<h4 class="h-beta">Getting started: The Probable Loneliness of the Beginnings</h4>
<p>In this part. we&#8217;ll reflect on collaborations and the almost unavoidable, and rewarding, loneliness of the beginnings. When you start building your stack/wall of projects while trying to answer the seminal question: “How can I find myself in the position of turning an “unfeasible” project into a “feasible” one?” it&#8217;s likely no one will trust you with their money or their time. Deal with it. Yourself. And get better at your craft.</p>
<h4 class="h-beta">Now there are people out there who want to help you: find them; talk to them.</h4>
<p>How many times have you found yourself thinking that it would be great to contribute to a project you love? How many times have you actually tried to? Well, now that your first project has launched, you will need help, and there are many folks around the globe who&#8217;d love to work with you but for one reason or another won&#8217;t try to get in touch with you. We&#8217;ll learn how to find them and how to start collaborating with them.</p>
<h4 class="h-beta">The Power of not Saying “No”.</h4>
<p>We&#8217;ll think about “control” and “open-mindedness”. We&#8217;ll try to understand why saying “yes” to the ideas people involved in your projects come up with (even the ones you totally don&#8217;t beliebe in!) will lead you into new, unexpected territories which you will probably not be able to discover if you try to control everything.</p>
<h4 class="h-beta">Be Ready to Give a Piece of Yourself to Your Projects, and Never Get It Back: How Not to Feel Bad About It.</h4>
<p>Your projects, like the devil, will take a toll on you. You will find yourself sitting with friends and family, maybe at important junctures in your life or theirs, and you will suddenly notice that part of your mind is stuck somewhere else (composing the next email, pre-writing the next article, drawing up a complex to-do list and whatnot). We&#8217;ll talk about not feeling guilty about this, which often happens, and we&#8217;ll reflect on the methods and discipline which can prevent you from not giving enough of yourself to the world outside.</p>
]]></content:encoded>
			<wfw:commentRss>http://bitspushedaround.com/on-thinking-in-platforms/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
		<item>
		<title>On Not Writing jQuery Plugins Anymore, But Instead Writing Plugins That Use jQuery</title>
		<link>http://bitspushedaround.com/on-not-writing-jquery-plugins-anymore-but-instead-writing-plugins-that-use-jquery/</link>
		<comments>http://bitspushedaround.com/on-not-writing-jquery-plugins-anymore-but-instead-writing-plugins-that-use-jquery/#comments</comments>
		<pubDate>Mon, 29 Oct 2012 17:01:42 +0000</pubDate>
		<dc:creator>alex</dc:creator>
				<category><![CDATA[Uncategorized]]></category>

		<guid isPermaLink="false">http://www.bitspushedaround.com/?p=115</guid>
		<description><![CDATA[Here&#8217;s a line of code that is, in about 90% of the jQuery plugins whose source I&#8217;ve read, absolutely useless: $.fn.myjQueryPlugin = ... What most jQuery plugins do is just use jQuery to do whatever they have to do, and for those plugins, extending jQuery is not very helpful or meaningful. Unless I specifically need [...]]]></description>
			<content:encoded><![CDATA[<p>Here&#8217;s a line of code that is, in about 90% of the jQuery plugins whose source I&#8217;ve read, absolutely useless:</p>
<pre><code>$.fn.myjQueryPlugin = ...
</code></pre>
<p>What most jQuery plugins do is <em>just use</em> jQuery to do whatever they have to do, and for those plugins, extending <code>jQuery</code> is not very helpful or meaningful.</p>
<p>Unless I specifically need to inject my plugins&#8217; methods into jQuery, why should I tie my public API so tightly to jQuery? Consider the following ways to fire some blahblahblah plugin:</p>
<pre><code>$("#some-div").blahblahblah();
blahblahblah.init( "#some-div" );
</code></pre>
<p>In terms of public API, the first line ties the blahblahblah plugin very tightly to jQuery, while the second line is &#8220;library agnostic&#8221;: it uses jQuery, but it doesn&#8217;t show.</p>
<p>When a plugin is released, it&#8217;s impossible to say what its lifespan is going to be, how successful it&#8217;s going to be, and how widespread across the internet it&#8217;s going to end up. Imagine you’re the owner of an incredibly successful piece of code. The way you coded your plugin, its public API (or to put it more simply, the lines of code that people type to use your plugin) is filtered through the prism of jQuery. And one day you want, for whatever reason, to untie yourself from any dependencies.</p>
<p>You&#8217;re going to have a hard time selling that idea to your users. Imagine telling them they now have to go through all the pieces of their own code to make it comply with your plugin&#8217;s new, &#8220;unleashed&#8221; API. Your fan base is quite literally going to melt down.</p>
<p>Whenever possible, it&#8217;s better to think in terms of composition|agreggation rather than extension. The looser the ties between pieces of software, the bigger the flexibility and the freedom of movement for the developer.</p>
<p>Off the top of my head, here are a few reasons why I don&#8217;t want my code to be too tightly tied to a library: </p>
<ul>
<li>
<p>A vague acquaintance releases her own framework, and for strategic reasons I have to support her, because she has a friend that has a friend that my best friend kinda likes, and she might set up a date for him, and, you know, if I can help&#8230;</p>
</li>
<li>
<p>A new framework is released, with a new philosophy that fits my ethics better and an amazing offer to fix my bike for me for a whole year if I endorse it.</p>
</li>
<li>
<p>John Resig bumps into me just before I walk on stage to speak at a conference, and my glass of water spills all over my pants, and John doesn&#8217;t apologize. The crowd, obviously, giggles a lot when the curtain rises and I&#8217;m alone on stage.</p>
</li>
</ul>
<p>Think about this before you start coding.</p>
]]></content:encoded>
			<wfw:commentRss>http://bitspushedaround.com/on-not-writing-jquery-plugins-anymore-but-instead-writing-plugins-that-use-jquery/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
		<item>
		<title>On HTML Document Outlines</title>
		<link>http://bitspushedaround.com/on-html-document-outlines/</link>
		<comments>http://bitspushedaround.com/on-html-document-outlines/#comments</comments>
		<pubDate>Thu, 12 Jul 2012 20:56:08 +0000</pubDate>
		<dc:creator>alex</dc:creator>
				<category><![CDATA[Uncategorized]]></category>

		<guid isPermaLink="false">http://www.bitspushedaround.com/?p=124</guid>
		<description><![CDATA[In the vast family composed of all the debates and discussions revolving around semantic markup and “HTML done right”, the question of document outlines could very well be the sad, neglected child sitting in the corner. Aside from a few posts about the accuracy of using the tag for a page title (or for a [...]]]></description>
			<content:encoded><![CDATA[<p>In the vast family composed of all the debates and discussions revolving around semantic markup and “HTML done right”, the question of document outlines could very well be the sad, neglected child sitting in the corner. Aside from a few posts about the accuracy of using the <code><br />
<h1></code> tag for a page title (or for a website’s title) and some considerations about HTML5’s content sectioning, the concept of outline has never really been debated (at least not as much as I’d have wished since <a href="http://www.iheni.com/html-5-to-the-h1-debate-rescue/" title="Heni - Outline">there&#8217;s only one place where it really took place</a>).</p>
<p>This state of affairs leaves me with a few questions, and cogitations, that I would like to present in this article, both to document my thoughts on the subject of outlines and, maybe, to go against a few preconceived ideas when it comes to what exactly <code> <h(n)></code> tags should wrap.</p>
<p>
<h4 class="h-beta">A myth already in hashes: only one <code><br />
<h1></code> tag per document</h4>
</p>
<p>For some time, there was a belief amongst web developers that there should be only one <code><br />
<h1></code> tag per document, and that it should hold the title of the page, or even the name of the website. Luckily, many people were smart enough to <a href="http://www.w3.org/TR/html401/struct/global.html#edef-H1" title="W3C - Headings">read the specs</a> and understand the true meaning of the following lines:</p>
<blockquote>
<p>There are six levels of headings in HTML with H1 as the most important and H6 as the least.</p>
</blockquote>
<p>And they <a href="http://www.brucelawson.co.uk/2009/headings-in-html-5-and-accessibility/" title="Bruce Lawson">preached <a href="http://www.youtube.com/watch?v=GIn5qJKU8VM" title="Youtube – Matt Cuts">the</a> <a href="http://html5doctor.com/the-section-element/" title="HTML5 Doctor - Bruce Lawson">good</a> <a href="http://adactio.com/articles/1704/" title="Adactio">word</a>.</p>
<p>I especially like what <a href="https://twitter.com/adactio" title="Twitter - Adactio">Jeremy</a> has to say about it:</p>
<blockquote>
<p>You can have multiple H1s in a document. This is not something new to HTML5. You have always been able to have multiple H1s in a document—shock, horror. I’ve met working professionals on the web who have thought for years that it was in the specification that you could only have one H1 in a document. </p>
</blockquote>
<p>A point I’d like to make, though, is that it wouldn’t be completely wrong to use a <code><br />
<h1></code> tag instead of, say, <code>
<p class="brand"></code> to mark up the title of a project. It would only really make sense, though, if the potentiality of having <em>more than one project name displayed on the same page</em> exists, which is highly unlikely (but it is fortunately a widely accepted practice not to have more than one web site co-existing on a single web page).</p>
<p>The real reason why the <code><br />
<h1></code> is a poor choice for holding the name of an application, or the title of a web page, is that the <code><br />
<h1></code> tag will never have any siblings, unless you purposefully decide to break the tacit rule which states that at a given endpoint (understand “url”), you find <em>one</em> specific website, not two or more, and <em>one</em> specific page, not two or more. </p>
<p>Those considerations clear up an early misunderstanding about <code><br />
<h1></code> &#8211; <code><br />
<h6></code> tags and allow us to make a statement about using them correctly: <strong>the potentiality for a given <code><h(n)></code> tag to have siblings holding information of equal importance should exist</strong>. In an outline, indeed, much information of the same importance should be able to coexist, if not practically, at least theoretically. If you wrap some text around a <code><h(n)></code> tag and you cannot find a possibility for content that would bear the same <code><h(n)></code>,  then you should question whether you’re using the right tag or not.</p>
<h4 class="h-beta">An outline shall outline&#8230; what, exactly?</h4>
<p>This being clarified, we can move to a deeper subject: what exactly should the nature of the text wrapped around <code><h(n)></code> tags be? The specs <a href="http://www.w3.org/TR/html401/struct/global.html#edef-H1" title="W3C - Headings">state</a> that  “a heading element briefly describes the topic of the section it introduces”. Translation: a heading element is contextual, and not structural. The words “contextual” and “structural” are of prime of importance here, and are sufficiently subject to interpretation to let us reflect on them a little. The general belief, it seems, is that <code><br />
<h1></code> &#8211; <code><br />
<h6></code> tags should mark only bits of text directly related to the specific <em>content</em> of a given document. Those bits of text, therefore, should be different with each document, and highly topical. It doesn’t seem that the word “context” should be understood in any way other than in its “specificity” meaning/sense. Here’s a coding example which exemplifies a content-oriented outline:</p>
<pre>
<code>
<h1>Plant Earth</h1>
<h2>Countries</h2>
<h3>...</h3>
<h2>Oceans</h2>
<h3>...</h3>
<h1>The Moon</h1>
<h2>Countries</h2>
<h3>...</h3>
<h2>Oceans</h2>
<h3>...</h3>

</code>
</pre>
<p>What is not topical, what has no <em>contextual specificity</em>, still according to our disembodied general belief (with broad shoulders), are bits of texts that refer to the structure of a given document. Here’s a coding example which exemplifies a structure-oriented outline:</p>
<pre>
<code>
<h1>Banner</h1>
<h2>Navigation</h2>
<h1>Main Content</h1>
<h2>Articles</h2>
<h3>...</h3>
<h2>Author</h2>
<h3>...</h3>
<h1>Complementary</h1>
<h2>Resources</h2>
<h3>...</h3>
<h2>Related Posts</h2>
<h3>...</h3>
<h1>Contentinfo</h1>
<h2>Copright</h2>
<h2>Humans</h2>

</code>
</pre>
<p>This second approach is probably considered wrong by many developers. But in my opinion it’s actually not. Please allow me to try to convince the most sceptical among you. The origin of my belief lies in a close analysis of the word “context”, which we must, in a pleasant <em>mise en abyme</em>, put into its own context: that of an HTML document.</p>
<h4 class="h-beta">What is the &#8220;context&#8221; of a document?</h4>
<p>The word “context” is not to be taken lightly, as it is key to the correct use of <code><h(n)></code> tags. The specs leave us hanging, though, when it comes to clarifying exactly how the word “topic” (&#8220;context&#8221;) should be understood:</p>
<blockquote>
<p>A heading element briefly describes the topic of the section it introduces.</p>
</blockquote>
<p>Anyone familiar with reading W3C’s specifications is no stranger to <a href="http://en.wikipedia.org/wiki/Hermeneutics">hermeneutics</a>, the art of extracting the hidden meaning of a text, the craft of deploying one’s own subjectivity based on textual evidence.</p>
<p>So let’s be like Hermes for a minute and try to be interpreters of the message coming from above.</p>
<p>The word “topic”, as provided by the specs, could easily be applied to the second outline approach, the structure-oriented one. Why? Because titles such as “banner”, “complementary” and “content info” are <em>semantically highly charged in the context of a web page</em>; they are almost literally <em>pouring with meaning</em>. People know what to expect in sections named “main content” and “banner”, and such expectations have <em>everything</em> to do with content, and context. </p>
<p>Are the words “banner”, “main” or “complementary” part of the content itself? I would be hard-pressed to say so. Yet the <em>particularly close relationship</em> that structure and content have in HTML documents allows me to say that a structural outline doesn’t betray the contextual approach encouraged by the specs. </p>
<p>And, in all subjectivity, I consider it more meaningful than the content one. Here is why. Consider our content-oriented outline in the two following contexts:</p>
<pre>
<code>
<!-- First Context: -->
<div role=”main”>
<h1>Plant Earth</h1>
<h2>Countries</h2>
<h3>...</h3>
<h2>Oceans</h2>
<h3>...</h3>
<h1>The Moon</h1>
<h2>Countries</h2>
<h3>...</h3>
<h2>Oceans</h2>
<h3>...</h3>
</div>

</code>
</pre>
<pre>
<code>
<!-- Second Context: -->
<div role=”complementary”>
<h1>Plant Earth</h1>
<h2>Countries</h2>
<h3>...</h3>
<h2>Oceans</h2>
<h3>...</h3>
<h1>The Moon</h1>
<h2>Countries</h2>
<h3>...</h3>
<h2>Oceans</h2>
<h3>...</h3>
</div>

</code>
</pre>
<p>The difference is so obvious that I barely dare state it: depending on where this content is laid out on the page, its importance, its meaning, its sense (semantics again), radically change. The idiosyncrasies of a web page play a pivotal role in my thinking, and such idiosyncrasies (what the user expects, how screen readers work, etc.), when put together with the purpose of an outline, simply make it quite clear that structure has a role to pay in HTML-related outlines, and cannot just be kept aside, as if it didn’t connote the content it wraps. </p>
<p>An HTML document is not a book, nor is it a magazine (where, by the way, structural outlines have become very popular in recent years). You have to put your hands down into everyday-life markup to understand what makes an outline a good outline, and you cannot just transpose theories that work for other mediums. Build projects, check their outlines, see which outlines lead you in the most direct way to the specific content your users may be looking for. Then tell me that structure has nothing to do with it.</p>
<p>Once the general structure of a document has been outlined, its content can be tackled. Outlines can only gain in clarity with a “from structure to content” approach.</p>
<h4 class="h-beta">And HTML5?</h4>
<p>HTML5’s sectioning elements seem to give weight to my arguments. With HTML5, specific elements are used to create content portions in which <code><h(n)></code> tags can deploy themselves more loosely:</p>
<p>HTML5’s sectioning elements free <code><h(n)></code> tags from the sequence consistency (h + 1,2,3,4,5,6) otherwise expected from them. Indeed, the importance of <code><h(n)></code> tags is reset within each new sectioning element (for the current sectioning element) thanks to their ability to <em>contribute to the outline of the document</em> (hence the “sectioning”). </p>
<p>Interestingly, sectioning elements are quite explicitly referring to areas of a web page. Even though <code><br />
<footer></code> should not be understood solely as “the bottom of the page” (a <code><br />
<footer></code> can also appear within each published article), it is striking that elements with a strong structural emphasis <em>also</em> influence the outline of a document. It’s as if HTML5 implicitly encouraged a structural approach to outline, or at least &#8211;the more sceptical readers will certainly agree&#8211; acknowledged that structure and outline weren’t two completely separate things in an HTML document. </p>
<p>Hermeneutics, I’ll admit it. But I feel my approach to outline isn’t going against standards, and that a “from structure to content” outline has a reason to exist.</p>
<h4 class="h-beta">Why does it matter?</h4>
<p>There are many reasons why a “from structure to content” outline matters. </p>
<p>First, because this approach is a test for your pages’ architecture: putting the same bits of content in different structural contexts is a strong indication of the role and importance you give to those very bits of content. It’s a sane practice to experiment with content connotation by placing it under various structural <code><h(n)></code> tags. Interesting thoughts and considerations come from such experiments: a structural outline enforces architectural questioning.</p>
<p>Second (and this point derives directly from the previous one), a “from structure to content” approach is an open door to personal &#8211;and possibly bold&#8211; statements: you can have an outline which clearly underlines your position with regard to content unfolding, and your own peculiar approach to information architecture. It makes it easy for your fellow developers to see the questions and experiments you are currently infusing into your work.</p>
<p>Third, and more importantly, a “from structure to content” outline helps ease some accessibility issues. While the visuals of your pages help underline the architecture of your content, screen readers, for example, rely a lot more on the markup of your pages to emphasize content importance. If you’re displaying a visually hidden outline (with internal links leading to specific parts of the content), it is fair to assume that the structural elements of your outline will be quite helpful.</p>
<pre>
<code>
<h1 class="visuallyhidden">Top Navigation</h1>
<h2 class="visuallyhidden">Jump To Section</h2>
<ul class="visuallyhidden" role="navigation">
<li><a href="#main" title="Jump to main content">Jump to main content</a></li>
<li><a href="#complementary" title="Jump to complementary content">Jump to complementary content</a></li>
<li><a href="#contentinfo" title="Jump to additional information">Jump to additional information</a></li>
</ul>

</code>
</pre>
<p>If you scan a page based on its outline, it is undeniable that mentioning structural sections is useful. It is also worth noting that structural <code><h(n)></code> tags can bring complementary information to what ARIA roles convey.</p>
<h4 class="h-beta">And In The End</h4>
<p>I hope I have taken good care of the neglected child that is HTML outline during this article. </p>
<p>I hope I’ve made a point about not being afraid to “do things the wrong way” (such a huge fear amongst front-end developers) if architectural indications are wrapped in <code><h(n)></code> tags. Those tags can actually prove complementary to ARIA roles and can help people navigate through your documents much more quickly than with a content-only outline.</p>
<p>I also hope I’ve honoured the specs with my interpretations. Maybe I did, or maybe, like Hermes, I’ve been a liar and a trickster.</p>
<h4 class="h-beta">A note on visibility</h4>
<p>It is very likely that structural <code><h(n)></code> tags will be hidden, while content-oriented <code><h(n)></code> will be visible. Which tag you decide to show/hide may actually be a test to determine the nature of a <code><h(n)></code> tag (structural/content-oriented).</p>
<p>Also, please note that Search Engines (as well as some social services) will grab the first <code>h(n)</code> they see &#8211;without caring about its visibility&#8211; and use it as part of their &#8220;content blurb&#8221;. This may produce unwanted results. But, frankly, I can be quite brazen when it comes to third party applications grabing my content: <em>they</em> have to adapt to the content they grab, and not the other way around.</p>
]]></content:encoded>
			<wfw:commentRss>http://bitspushedaround.com/on-html-document-outlines/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
	</channel>
</rss>
