added separate bugs doc and reorganized documentation in preparatino for pull-request