<?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>infotexture &#187; Markdown</title>
	<atom:link href="http://infotexture.net/tag/markdown/feed/" rel="self" type="application/rss+xml" />
	<link>http://infotexture.net</link>
	<description>Information Architecture &#38; Content Strategy</description>
	<lastBuildDate>Sat, 03 Sep 2011 14:59:26 +0000</lastBuildDate>
	<language>en</language>
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
	
		<item>
		<title>Accessible Documentation</title>
		<link>http://infotexture.net/2010/06/accessible-documentation/</link>
		<comments>http://infotexture.net/2010/06/accessible-documentation/#comments</comments>
		<pubDate>Thu, 03 Jun 2010 21:22:46 +0000</pubDate>
		<dc:creator>roger</dc:creator>
				<category><![CDATA[Design]]></category>
		<category><![CDATA[Speaking]]></category>
		<category><![CDATA[Standards]]></category>
		<category><![CDATA[accessibility]]></category>
		<category><![CDATA[documentation]]></category>
		<category><![CDATA[Markdown]]></category>
		<category><![CDATA[presentation]]></category>
		<category><![CDATA[S5]]></category>

		<guid isPermaLink="false">http://blog.infotexture.net/?p=321</guid>
		<description><![CDATA[I was recently asked to give a presentation on the relationship between technical documentation and accessibility for an event held at the University of Applied Sciences here in Potsdam. The event was organized by the Institute for Information and Documentation (IID) in the Faculty of Information Science and supported by the German-Austrian office of the [...]]]></description>
			<content:encoded><![CDATA[<p>I was recently asked to give a presentation on the relationship between technical documentation and accessibility for an event held at the <em>University of Applied Sciences</em> here in Potsdam.</p>

<p>The <a href="http://www.iid.fh-potsdam.de/4554.html">event</a> was organized by the <em>Institute for Information and Documentation</em> (IID) in the Faculty of Information Science and supported by the German-Austrian office of the <em>World Wide Web Consortium</em> (<a href="http://www.w3.org/">W3C</a>).</p>

<p>In the German words of the organizers:</p>

<blockquote>
  <p>Die Veranstaltung gibt einen Überblick über die Grundlagen der Barrierefreiheit in der technischen Dokumentation. Dabei stellt das Seminar auch die speziellen Anforderungen an zugängliche Dokumente aus der Sicht der Betroffenen als entscheidende Experten in eigener Sache dar.</p>
</blockquote>

<p>My role was to describe the environment in which technical documentation is created and provide an overview of current “best practices” in technical documentation that provide a foundation for accessible documents.</p>

<p>My main point was that accessibility need not be viewed as an expensive afterthought tacked on for the benefit of a minority, but rather as a natural byproduct of documentation done well. This borrows from the concept of “<a href="http://en.wikipedia.org/wiki/Universal_design">universal design</a>” in that the same best practices used to produce good documentation also provide a solid foundation for accessibility – built-in for the benefit of all users.</p>

<p>In keeping with one of the most important principles in information design – the separation of content and presentation – I prepared my slides using a plain text file in <a href="http://daringfireball.net/projects/markdown/">Markdown</a> format and converted to XHTML for presentation via the <em>Simple Standards-based Slide Show System</em> (<a href="http://meyerweb.com/eric/tools/s5/">S5</a>).</p>

<p>If you&#8217;d like to see the slides <em>(in German)</em>, an archive of the source file and XHTML output is available <a href="http://blog.infotexture.net/wp-content/uploads/2010/06/accessible-documentation.zip">here</a>. The S5 file is the plain text version that can be opened in any text editor. The HTML version contains the slides as they were presented <em>(requires a standards-compliant browser such as Chrome, Firefox or Safari, with JavaScript enabled)</em>.</p>

<h2>Recommended Reading</h2>

<p>For more information on universal design, PDF accessibility, and issues with the latest version of the <em>Web Content Accessibility Guidelines</em>, the following articles on <em>A List Apart</em> are a good place to start:</p>

<ul>
<li><a href="http://www.alistapart.com/articles/the-inclusion-principle/">The Inclusion Principle</a></li>
<li><a href="http://www.alistapart.com/articles/pdf_accessibility/">Facts and Opinions About PDF Accessibility</a></li>
<li><a href="http://www.alistapart.com/articles/tohellwithwcag2/">To Hell with WCAG 2</a></li>
</ul>

<hr />
]]></content:encoded>
			<wfw:commentRss>http://infotexture.net/2010/06/accessible-documentation/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
		<item>
		<title>HumaneText.service</title>
		<link>http://infotexture.net/2007/08/humanetextservice/</link>
		<comments>http://infotexture.net/2007/08/humanetextservice/#comments</comments>
		<pubDate>Fri, 24 Aug 2007 19:45:19 +0000</pubDate>
		<dc:creator>roger</dc:creator>
				<category><![CDATA[Mac]]></category>
		<category><![CDATA[Productivity]]></category>
		<category><![CDATA[Tools]]></category>
		<category><![CDATA[Markdown]]></category>
		<category><![CDATA[OSX]]></category>

		<guid isPermaLink="false">http://blog.infotexture.net/index.php/2007/08/24/humanetextservice/</guid>
		<description><![CDATA[Fans of John Gruber&#8217;s Markdown will appreciate HumaneText.service, a system-wide Mac OS X service that translates between markdown and XHTML with quick key-commands: Shift+Apple+{ and Shift+Apple+}. Simply beautiful! If you haven&#8217;t heard of markdown, it&#8217;s a simple and elegant means of writing plain text that is highly readable &#8220;as is&#8221;, yet easily converted to HTML. [...]]]></description>
			<content:encoded><![CDATA[<p>Fans of John Gruber&#8217;s <a href="http://daringfireball.net/projects/markdown/">Markdown</a> will appreciate <a href="http://gu.st/proj/HumaneText.service/">HumaneText.service</a>, a system-wide Mac OS X service that translates between markdown and XHTML with quick key-commands: <kbd>Shift</kbd>+<kbd>Apple</kbd>+<kbd>{</kbd> and <kbd>Shift</kbd>+<kbd>Apple</kbd>+<kbd>}</kbd>. <strong>Simply beautiful!</strong></p>

<p>If you haven&#8217;t heard of markdown, it&#8217;s a simple and elegant means of writing plain text that is highly readable &#8220;as is&#8221;, yet easily converted to HTML. As the author says:</p>

<blockquote>
  <p>The overriding design goal for Markdown&#8217;s formatting syntax is to make it as readable as possible. The idea is that a Markdown-formatted document should be publishable as-is, as plain text, without looking like it&#8217;s been marked up with tags or formatting instructions. While Markdown&#8217;s syntax has been influenced by several existing text-to-HTML filters, the single biggest source of inspiration for Markdown&#8217;s syntax is the format of plain text email.</p>
</blockquote>
]]></content:encoded>
			<wfw:commentRss>http://infotexture.net/2007/08/humanetextservice/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
	</channel>
</rss>

