add some necessary documentation