From d03984b3fc09fc55e82769ef3acbf1992ce375d1 Mon Sep 17 00:00:00 2001
From: Oleksandr Kuzminskyi <aleks@infrahouse.com>
Date: Mon, 12 Jan 2026 18:02:54 -0800
Subject: [PATCH] Add lifecycle blocks to prevent overwriting docs content

Prevent Terraform from updating docs/index.md and mkdocs.yml content
after initial creation, allowing manual customization per repository.
---
 modules/plain-repo/files/docs.yml | 2 +-
 modules/plain-repo/repos-files.tf | 8 ++++++++
 2 files changed, 9 insertions(+), 1 deletion(-)

diff --git a/modules/plain-repo/files/docs.yml b/modules/plain-repo/files/docs.yml
index aed6e23..516976f 100644
--- a/modules/plain-repo/files/docs.yml
+++ b/modules/plain-repo/files/docs.yml
@@ -1,7 +1,7 @@
 ---
 name: 'Deploy Documentation'
 
-on:
+on:  # yamllint disable-line rule:truthy
   push:
     branches:
       - main
diff --git a/modules/plain-repo/repos-files.tf b/modules/plain-repo/repos-files.tf
index 9f7a099..9650c3b 100755
--- a/modules/plain-repo/repos-files.tf
+++ b/modules/plain-repo/repos-files.tf
@@ -143,6 +143,10 @@ resource "github_repository_file" "docs_index" {
   content             = "# ${github_repository.repo.name}\n\n${github_repository.repo.description}\n"
   commit_message      = "Add docs/index.md"
   overwrite_on_create = false
+
+  lifecycle {
+    ignore_changes = [content]
+  }
 }
 
 resource "github_repository_file" "mkdocs_config" {
@@ -157,4 +161,8 @@ resource "github_repository_file" "mkdocs_config" {
   })
   commit_message      = "Add mkdocs.yml configuration"
   overwrite_on_create = false
+
+  lifecycle {
+    ignore_changes = [content]
+  }
 }