doctoc generates TOC before Title, unlike sample about doctoc

[thlorenz]

doctoc places the TOC always on top of the file and includes the main title like you described.
I usually go in and edit the file afterwards.

Since the toc is always on top it helps doctoc to replace it with an updated one if necessary see here.

This could be improved however and I'd love to see and pull in contributions that improve this.

[lazd]

It would be nice to see the table of contents go under the heading and quote:

# My Cool Project
> Definitely the coolest thing since the ice age

## How to be cool

There's only one rule: act cool.

## When it's not cool to be cool

Funerals.

When toc'd, I'd like to see:

# The Cool Project
> Definitely the coolest thing since the ice age

- [The Cool Project](#the-cool-project)
    - [How to be cool](#the-art-of-being-cool)
    - [When it's not cool to be cool](#when-its-not-cool-to-be-cool)

## How to be cool

There's only one rule: act cool.

## When it's not cool to be cool

Funerals.

[thlorenz]

Actually in that case The Cool Project should probably not be part of the toc, since the toc is below that heading, don't you think?
So if we'd omit that, we would possibly have to adjust indentation level as well.

This could easily be implemented, i.e.. with update-section, we just have the hash out all the edge cases like the ones I just mentioned first.

[lazd]

Yeah, I totally agree -- The Cool Project shouldn't be part of the TOC.

[thlorenz]

Ok, and I this will already take care of correct indentation even if there is no # header.

So this should be fairly simple with the update-section module I mentioned above. I'm a bit swamped right now so it may be a while.
However any PR that beats me to it along with nice tests will be very welcome ;)

[thlorenz]

This fix has been published with 0.5.1. doctoc now replaces existing tocs instead of always adding a new one to the top of the file.