Show your workings

I spend quite a lot of time working out how to do things in code. Which tends to make it look like I am not doing much producing of code

Which means I want a nice way of “showing my working”

  1. I have a story to do
  2. If it is not trivial, I need to
    1. experiement with different solutions
    2. measure, collate the results
    3. publish the results.

There is no ground-breaking stuff in here. Just a nice way of saying how to do stuff.

Think ... each experiment should result in a blog post like a web framework shoot-out.

Examples

Include a python file

This is a snippet from a file

def hello_world(name):
    """
    A new way of saying hello
    """
    return "Hello World and %s" % name

def dontshowthisone():
    """
    shown in a full include, not in by-object include
    """
    pass

This is including just one object

def hello_world(name):
    """
    A new way of saying hello
    """
    return "Hello World and %s" % name

This is including just lines

def hello_world(name):
    """
    A new way of saying hello
    """
    return "Hello World and %s" % name

We can also use : include : to include a whole file but it is not really meeting our purpoases