resource/gitlab_service_github: Improve documentation and reference upstream docs

Author: timofurrer

docs/resources/service_github.md

@@ -3,15 +3,18 @@
 page_title: "gitlab_service_github Resource - terraform-provider-gitlab"
 subcategory: ""
 description: |-
-  NOTE: requires either EE (self-hosted) or Silver and above (GitLab.com).
-  This resource manages a GitHub integration https://docs.gitlab.com/ee/user/project/integrations/github.html that updates pipeline statuses on a GitHub repo's pull requests.
+  The gitlab_service_github resource allows to manage the lifecycle of a project integration with GitHub.
+  -> This resource requires a GitLab Enterprise instance.
+  Upstream API: GitLab REST API docs https://docs.gitlab.com/ee/api/integrations.html#github
 ---
 
 # gitlab_service_github (Resource)
 
-**NOTE**: requires either EE (self-hosted) or Silver and above (GitLab.com).
+The `gitlab_service_github` resource allows to manage the lifecycle of a project integration with GitHub.
 
-This resource manages a [GitHub integration](https://docs.gitlab.com/ee/user/project/integrations/github.html) that updates pipeline statuses on a GitHub repo's pull requests.
+-> This resource requires a GitLab Enterprise instance.
+
+**Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/ee/api/integrations.html#github)
 
 ## Example Usage
 

internal/provider/resource_gitlab_service_github.go

@@ -12,8 +12,11 @@ import (
 
 var _ = registerResource("gitlab_service_github", func() *schema.Resource {
 	return &schema.Resource{
-		Description: "**NOTE**: requires either EE (self-hosted) or Silver and above (GitLab.com).\n\n" +
-			"This resource manages a [GitHub integration](https://docs.gitlab.com/ee/user/project/integrations/github.html) that updates pipeline statuses on a GitHub repo's pull requests.",
+		Description: `The ` + "`gitlab_service_github`" + ` resource allows to manage the lifecycle of a project integration with GitHub.
+
+-> This resource requires a GitLab Enterprise instance.
+
+**Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/ee/api/integrations.html#github)`,
 
 		CreateContext: resourceGitlabServiceGithubCreate,
 		ReadContext:   resourceGitlabServiceGithubRead,