Saturday, May 21, 2011

Audience and Content Layout


Go Programming Tutorial Series - Audience

I expect that the usage of the Go programming language will grow significantly in the time to come. However, for now it is only in the early stages of adoption around the world. In my attempts to learn the language there was an initial minor speed bump given that the syntax is sometimes slightly different and that it also has certain idiomatic syntax - once you know it, it is great, but if you attempt to read a regular c/java/c#/c++ background and expect to understand the program, it wouldn’t work. So I foresee an audience of varying competencies to be reading these articles. Therefore I am going to make a bold attempt to cater to a wide audience, all the way from absolute beginners to experienced people who need a few bits of code for the occasional reference. The way I intend to do this is by separating the content targeted at various expertise levels with distinguishing icons and layout.

Layout

Beginners: Content for beginners will look as shown below. People who are new to programming and new to the Go language should go through this.

This is content for beginners.

Intermediate: People who have done some programming in the past but are new to the Go language should go through this. There will also be quite a few examples to cover a good part of the possibilities of that section. So it could be very useful for those who want to quickly lookup how a certain function may be used or a certain functionality may be achieved.

This is content for intermediates.

Expert: People who have done quite a bit of programming in the past could use this section. This section will contain slightly advanced topics and examples. But looking out from the beginning at this point, I suspect there would be fewer sections of this. The Go language is fairly simple and complexity is only reached based on individual application design.

This is content for experts.

Also, some of the other layout styles.
This is output as we would not want - or error output.

This is output as we would want - or correct output.

An additional note or opinion will look like this.

//This is what Go code will look like

package main

import (
        "fmt"
)

func main() {
        fmt.Println("This is easily readable.")
}

Certain systems commands, file names, directory paths, and some titles will look like this: filename, ls -l, /a/path/to/a/directory

4 comments:

If you think others also will find these tutorials useful, kindly "+1" it above and mention the link in your own blogs, responses, and entries on the net so that others also may reach here. Thank you.

Note: Only a member of this blog may post a comment.