diff --git a/.github/readme-assets/github-octocat-dark.svg b/.github/readme-assets/github-octocat-dark.svg
new file mode 100644
index 0000000000..527ba11c50
--- /dev/null
+++ b/.github/readme-assets/github-octocat-dark.svg
@@ -0,0 +1,10 @@
+
diff --git a/.github/readme-assets/github-octocat-light.svg b/.github/readme-assets/github-octocat-light.svg
new file mode 100644
index 0000000000..4e37ca0618
--- /dev/null
+++ b/.github/readme-assets/github-octocat-light.svg
@@ -0,0 +1,3 @@
+
diff --git a/.github/readme-assets/hashicorp-terraform-dark.svg b/.github/readme-assets/hashicorp-terraform-dark.svg
new file mode 100644
index 0000000000..43370166dc
--- /dev/null
+++ b/.github/readme-assets/hashicorp-terraform-dark.svg
@@ -0,0 +1,23 @@
+
diff --git a/.github/readme-assets/hashicorp-terraform-light.svg b/.github/readme-assets/hashicorp-terraform-light.svg
new file mode 100644
index 0000000000..1d66ee6da3
--- /dev/null
+++ b/.github/readme-assets/hashicorp-terraform-light.svg
@@ -0,0 +1,23 @@
+
diff --git a/README.md b/README.md
index 6e9aff2259..d473cb4cf4 100644
--- a/README.md
+++ b/README.md
@@ -1,9 +1,35 @@
# 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/).