diff --git a/README.md b/README.md
index 6e9aff2259..f56f57d8bf 100644
--- a/README.md
+++ b/README.md
@@ -1,9 +1,39 @@
# Terraform Provider GitHub
=========================
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
+# Terraform Provider GitHub
+
+Manage GitHub resources such as repositories, teams, and files using Terraform.
+
+- Provider documentation:
+ https://registry.terraform.io/providers/integrations/github/latest/docs
+
+- Terraform documentation:
+ https://developer.hashicorp.com/terraform
This project is used to manipulate GitHub resources (repositories, teams, files, etc.) using Terraform. Its Terraform Registry page can be found [here](https://registry.terraform.io/providers/integrations/github/).
diff --git a/readme-assets/github-octocat-dark.svg b/readme-assets/github-octocat-dark.svg
new file mode 100644
index 0000000000..527ba11c50
--- /dev/null
+++ b/readme-assets/github-octocat-dark.svg
@@ -0,0 +1,10 @@
+
diff --git a/readme-assets/github-octocat-light.svg b/readme-assets/github-octocat-light.svg
new file mode 100644
index 0000000000..4e37ca0618
--- /dev/null
+++ b/readme-assets/github-octocat-light.svg
@@ -0,0 +1,3 @@
+
diff --git a/readme-assets/hashicorp-terraform-dark.svg b/readme-assets/hashicorp-terraform-dark.svg
new file mode 100644
index 0000000000..43370166dc
--- /dev/null
+++ b/readme-assets/hashicorp-terraform-dark.svg
@@ -0,0 +1,23 @@
+
diff --git a/readme-assets/hashicorp-terraform-light.svg b/readme-assets/hashicorp-terraform-light.svg
new file mode 100644
index 0000000000..1d66ee6da3
--- /dev/null
+++ b/readme-assets/hashicorp-terraform-light.svg
@@ -0,0 +1,23 @@
+