Update GitHub importer documentation to reflect current importer state
What does this MR do?
Update the Github importer documentation to reflect the current importer state.
What are the relevant issue numbers?
https://gitlab.com/gitlab-org/gitlab-ee/issues/904