trying to make the documentation more beautiful

[yongninglei]

it's on going, will let you know when it's finished.

I am moving all the documentation up rather than mixed with the example real code