Creating complex “tutorials” using a blogging platform such as wordpress …

I am going to take the opportunity to write about “Blogging Stuff” topic on my very first article on 2011. This time I have been trying to understand how to publish “Complex” tutorials using the “WordPress.org” platform and for that I mean something that goes beyond the scope of one single article or blog entry. Simple tutorials can be written entirely using one blog entry which is pretty convenient for the publisher but when the content of an subject matter is complex in nature (long text paragraphs, tons of pictures, examples, code snippets, videos and so on)  then the next logical step is to break the whole into small pieces that can be assimilated or explored easily by the intended audience and still be considered atomic (one complete thing).

So without a lot of research on the topic and mostly using empiric knowledge about how tutorials in general are structured, here it is an attempt to tackle just few of the issues that a good tutorial structure thrives to resolve.

Read the rest of this entry »

Article 2.2.1

This is not a real tutorial but an example of a basic tutorial structure proposed in “Creating complex ‘tutorials’ using a blogging platform such as wordpress …

This is the layout example for:

Article 2.2.1

At the bottom of the article we need to add the navigation section, that will point to TOC that we will call “Main Index”, This blog post is also expected to point to “Previous” link that is actually “Section 2.2” page in this case. This is the first article at this level and the last element in the path so “Next” link is not available so in this case it will be gray out.

Go to Main Index, go to Section 2.2 index <– Previous Next –>

Article 2.1

This is not a real tutorial but an example of a basic tutorial structure proposed in “Creating complex ‘tutorials’ using a blogging platform such as wordpress …

This is the layout example for:

Article 2.1

At the bottom of the article we need to add the navigation section, that will point to TOC that we will call “Main Index”, This blog post is also expected to point to “Previous” link that is actually “Section 2” page in this case. This is the first article at this level but in this case is pointing to “Section 2.2” as it is the next element in the path.

Go to Main Index, go to Section 2 index <– Previous Next –>

Article 1.3

This is not a real tutorial but an example of a basic tutorial structure proposed in “Creating complex ‘tutorials’ using a blogging platform such as wordpress …

This is the layout example for:

Article 1.3

At the bottom of the article we need to add the navigation section, that will point to TOC that we will call “Main Index”, This blog post is also expected to point to “Previous” link that is actually “Article 1.2” post in this case. This is the last article at this level so it should not have a pointer to next but it will be wise to point to next section if available.

Go to Main Index, go to Section 1 index <– Previous Next –>