write some documentation about includes

close #462