Redesigning DontCodeTired.Com (Part 4) - Adding Semantic HTML 5 Markup and Removing Unwanted Elements

Redesigning DontCodeTired.Com (Part 3) - Creating Content Reference Wireframes using Mobile-First Responsive In-Browser Design

Adding New HTML5 Semantic Tags

DontCodeTired.com is currently using the open source BlogEngine.Net. The markup that is currently rendered uses divs for organizing content and layout. HTML 5 gives us some new semantic elements that can give greater meaning to the content. While there seems to be differing advice in the exact usage of some of these elements, for now I'm doing what I think makes the most semantic sense for my content.

The following new HTML 5 tags have been introduced to the markup:

<header> which also contains the main site navigation in a child <nav>

<article> now surrounds each individual blog entry.

All <article> elements are surrounded in a common <section> to differentiate the articles from the sidebar content which is also in a <section>.

Each <article> now has it's own <footer> and <header>. These two new elements can appear multiple times on a page. The header contains the post title and publish date. The footer contains the social bookmarks, post rating etc. (The social bookmarks used to be contained in a <div>, this has now been changed to a <section> as the content is "thematically related"). Note: the new <section> element should not be used to replace all <divs> especially those divs which are used purely for layout, etc. Instead it should be used to give semantic meaning to the content it contains.

Each right-hand widget (tagcloud, recent posts, etc) is contained in a <section>. I considered using an <article> or <aside> instead of a <section> but these tags didn't seem quite right, I may change them in the future once HTML5 adoption increases and common usage patterns emerge.

<footer> for page footer.

<time> element to represent the publication date of the blog entry, e.g. <time pubdate="pubdate" datetime="2012-04-25T14:22:00">Wednesday 25 April 2012 14:22</time>

Note: the pubdate="pubdate" is the XHTML5 variant, you could also use: <time pubdate datetime="2012-04-25T14:22:00">Wednesday 25 April 2012 14:22</time>

Coining a Term - Semantic Structure Wireframe

So I came up with this idea of a Semantic Structure Wireframe. A Semantic Structure Wireframe is an outline of how content is broken down and organized semantically using the new HTML 5 tags. It is meant to be a high level view of the blocks of semantic content the will be represented on the page.

An example of a Semantic Structure Wireframe for the DontCodeTired.com page viewing a page with multiple blog posts: 

Semantic Structure Wireframe

To enable older browsers to be able to recognize and style these new HTML5 tags, I'm including HTML5 Shiv. Similarly as I will be using CSS 3 media queries to create a responsive design I've also included Respond.js to add CSS 3 min/max-width media query support to older browsers. These 2 files are actually included as part of a custom build, in additional to things like Modernizr created at initializr.com). The Initializr package also contains some HTML5 compatible CSS reset styles which I've also included.

Removal of Unwanted Elements

Some elements that I no longer wanted were also removed at this stage - these are things that I don't want on any device or screen resolution:

  • 'filter by APML' link
  • log in/out link in main menu when logged out - appears only when logged in
  • "by Jason" on each article - as I'm the only one that posts it's redundant :)

Adding ARIA Landmark Roles

The Accessible Rich Internet Applications specification allows authors to add additional 'metadata' in order to "to allow assistive technologies to convey appropriate information to persons with disabilities". This helps assistive technologies (such as screen readers) to better understand and navigate content. The Landmark Roles "are regions of the page intended as navigational landmarks". These roles can be used in addition to HTML5 semantic markup.

The following Landmark Roles have been added to DontCodeTired HTML5 elements:

  • <header id="header" role="banner">
  • <nav id="menu" role="navigation">
  • <article role="article">
  • <footer id="dctMasterPageFooter" role="contentinfo">

Screenshots of desktop and wp7 at this stage (note some formatting has broken i.e. right hand widgets don't have backgrounds anymore), this will be fixed when we come to do the styling.

 

screenshot of desktop browser

screenshot of Windows Phone 7 Browser

SHARE:

Redesigning DontCodeTired.Com (Part 3) - Creating Content Reference Wireframes using Mobile-First Responsive In-Browser Design

Redesigning DontCodeTired.Com (Part 2) - Designing with Personality

This step is all about deciding what content will go where, and more importantly what content will be removed when viewed on mobile or tablet devices.

I could use an image editor (Photoshop, Inkscape, Paint.Net, etc) to create some wireframes and decide what content to put in them.

An alternative is to do in-browser design. This means actually creating the wireframes using HTML and CSS. The advantage of this is that I can iterate really quickly through designs and actually view the wireframes in the browser or mobile emulator. By using CSS 3 media queries I can experiment with mobile and tablet wireframes early on to get a feel for the final implementation in the actual target technology (HTML & CSS) rather than having to translate from a bitmap (Photoshop, etc.) at a later date.

As a starting point and with 'mobile first' and 'progressive enhancement' in mind, the first wireframe is a simple linear design where the majority of content flows from top to bottom. The value of starting with the most basic, most simple, linear design is that it forces us to concentrate on the most 'accessible', mobile-friendly version first. Once this is done we can add  extra content for non-mobile/desktop resolutions.

Initially I tried using markup (using Pandoc) but found it wasn't adding much value, so switched to just writing the HTML manually.

I am using SASS to make writing the CSS a bit easier using the SASS command line. You could also use Visual Studio with the awesome (and free) Web Workbench for the SASS compilation.

(SASS is an way of writing CSS at a slightly higher abstraction layer and allow variables for repeated values etc. or in their words: "Sass makes CSS fun again")

Stop in the Name of love Text

I got as far as an initial wireframe for mobile and a design for 800px width screen then I started to read about the ideas of "typography first" and "content-out, not canvas-in" approaches. As I want the content (text) to be the most important thing in the redesign, I decided to not do any more work on the content reference wireframes at this point.

A future step will be to start with some sample content and figure out how the typography will affect the layout and where the responsive breakpoints will naturally occur when taking into account measure, leading, font size, etc.

The image below show a content reference wireframe for the multiple posts page (as viewed in the Windows Phone emulator).

SHARE:

Redesigning DontCodeTired.Com (Part 2) - Designing with Personality

Redesigning DontCodeTired.Com (Part 1) - The Content Inventory

Users Personas

User personas are a way to try and understand the user base by inventing archetypal  representative users at a more human level. Creating them forces you to actually think about who is or will be using the site, and more importantly what content might give them a reason to be on the site in the first place.

Tim Smith

Tim Smith lives in London, England and he's in his mid-thirties. He's a professional software developer with 10+ years experience, working at a large corporation who's primary business is not the creation of software. He works in the IT department which is separated by organizational structure from the business. He loves writing software and using new technology but doesn't often get a chance to exercise this at work as his employer is slow to change and not really interested in software craftsmanship or long term quality. Tim loves to spend some of his spare time learning new stuff and contributing to the open source community, he's also love to self-publish mobile and tablet apps in the future. He uses the Internet partly for reference info (class structures, APIs, etc) but also enjoys more in-depth tutorial-like material so he can expand his knowledge and be exposed to new ideas. Tim also likes chilling out, playing acoustic guitar and XBOX, and walking in the English national parks.

Sarah Bells

Sarah Bells is a mid-twenties, formally untrained software developer with a huge passion for software development. She's currently working in Boston, USA at a small start-up working long hours but loving it as she's in control of what technology is used and she's able to use all the latest cool libraries. When she's not at work she loves dining with friends and letting off steam at local bars and clubs.  She wants to find answers to things quickly and usually has a thousand browser tabs open. Sarah occasionally makes time for more in-depth tutorials.

Mellisa Brand

Mellisa Brand is a 2nd year university student studying computer science. She loves the theory but occasionally finds it hard to see how she would do things in the 'real world'. She loves casually reading online material to get a feel for what is happening, she rarely  tries the ideas out in code herself. As a student she loves socializing in University bars.

David Lions

David Lions is a recruiter specializing in finding top quality developers. He was a developer himself for a while but found his way into his current job. Whilst he no longer actively develops software, he uses blogs, twitter etc. to get a feel for potential candidates before approaching them. David always gets high praise as he always provides top quality candidates for companies to interview.

Design persona

A design persona is a way of thinking about what personality the site will possess. It's a way of thinking about how the site will connect with people in a human, personal, emotional way.

Brand Name

DontCodeTired.Com Blog

Overview

DontCodeTired.Com Blog is the personal blog site of Jason Roberts, a software developer with 13+ years of commercial experience. The site has been running since 25th January 2005 and has a mixture of content from simple short articles to more tutorial style\length pieces. The blog mostly focuses on Microsoft based development technology but has some non-Microsoft specific content such as JavaScript. It also has some content on more general software development topics.

Desired Brand Traits

  • knowledgeable but not condescending
  • clear but not elitist
  • valuable but not limited
  • friendly but not chatty
  • honest but not mean
  • avoid: shallow or poorly written content

Voice

DontCodeTired's voice is friendly and personal, it's speech-like and somewhat casual using contractions and occasional slang over formal and stuffy speech. It doesn't try to be overly cool but is not afraid to have some fun on occasion (as long as it doesn't detract too much from the information).

Copy examples

  • Success message: "All done, thanks!"
  • Error message: "Sorry, something wen't wrong..."
  • Critical failure: "Sorry, something is really broken at the moment..."

Visual Lexicon

Color

DontCodeTired's colors are clean and mostly understated. Where color highlights are needed they are saturated and bright. Solid blocks of color are preferred to gradients.

Typography

DontCodeTired is all about the article content. Main content typography will use clean readable sans-serif fonts with a predictable type ramp. DontCodeTired's overall design will be based heavily on the readability of text.

General Style

Taking some ques from Metro design, interface elements will mostly focus on content over chrome, elevating the article content to the fore, relegating non important navigation and other elements to the ground.

SHARE:

Redesigning DontCodeTired.Com (Part 1) - The Content Inventory

This is the first in a series of posts describing how I am redesigning the DontCodeTime.com blog.

DontCodeTired is looking tired and boring, it also sucks when viewed on a mobile phone, hence I've decided to do a redesign. I am not a designer, if I was willing to pay for a designer (and I knew where to find one) I may have decided to use one. Certainly for a commercial project I would push heavily for a professional designer to be employed.

Building a content inventory

A content inventory is a way of examining and documenting the content that is currently on the site. This will not mean every individual post at this point, rather the key areas of content. The point of doing this is so at a later stage we can consciously decide what content is suitable for what devices, we may even throw away content completely.

At this point I don't want to pre-think about the actual new design - other than some what-extra-stuff-could-I-add.

Current DontCodeTired Content Inventory

Common to all pages
- Page header (title + sub title)
- Page footer ( be logo, dct link, terms of use link)
- Main nav menu
    - home
    - archive
    - contact
    - subscribe (rss)
    - log in
    - filter by APML

Common sidebars
- Silverlight apps links
- Tag cloud
- Recent posts
- Search box

Archive

Contact
- form

Log in page

Terms of use

Article (short view)
- Body Title
- by jason
- date time pub
- Body content
- rating
- tags
- sharing (email etc)
- permalink
- comment clink
- post RSS

Article (full view)
- prev next nav bar
- Body Title
- by jason
- date time pub
- Body content
- rating
- tags
- sharing (email etc)
- permalink
- comments link
- post RSS
- related posts
- comments
    

Possible New Content

- Advertisements: min one one each page, between posts, maybe side bar
- Logo
- Follow me on twitter button
- latest tweets/tweet? (only desktop & tablet??)
- Linked in profile link???
- My WP7 apps links
- My OS projects links
- Technical Debt Simulator
- share on g+
- share on fb
- share on twitter
- about me box (short aside) with link to longer about me page
- about me longer page

How it looks at this point

 






Redesigning DontCodeTired.Com (Part 2) - Designing with Personality

SHARE: