From 15aa566cf25bd9972a9291c4bad299cf4bc5b441 Mon Sep 17 00:00:00 2001
From: Bhupesh-V <varshneybhupesh@gmail.com>
Date: Sat, 3 Feb 2024 23:52:46 +0530
Subject: [PATCH]  new meta til

---
 ...enting-medium-scale-system-architecture.md | 19 +++++++++++++++++++
 README.md                                     |  3 ++-
 SUMMARY.md                                    |  1 +
 count.json                                    |  2 +-
 recent_tils.json                              | 16 ++++++++--------
 5 files changed, 31 insertions(+), 10 deletions(-)
 create mode 100644 Meta/checklist-documenting-medium-scale-system-architecture.md

diff --git a/Meta/checklist-documenting-medium-scale-system-architecture.md b/Meta/checklist-documenting-medium-scale-system-architecture.md
new file mode 100644
index 0000000..c9462b2
--- /dev/null
+++ b/Meta/checklist-documenting-medium-scale-system-architecture.md
@@ -0,0 +1,19 @@
+# Checklist for documenting a medium to large scale system architecture
+
+**_Posted on 03 Feb, 2024_**
+
+Some items that can help you document a undocumented legacy system.
+
+- [ ] Identify common points of failure in the architecture.
+- [ ] Identify uptime maintained in the last year (in 9s).
+- [ ] Identify maintainer/dev team size.
+- [ ] Identify specific version numbers of SDKs, APIs and packages used.
+  - [ ] Identify if updating SDKs can break the system.
+- [ ] Get entire server inventory list with os details.
+- [ ] Create documentation for the deployment strategies.
+- [ ] Create as many flowcharts/visual representations of the modules as possible. Way more than textual documents.
+- [ ] Make notes. Make lots of notes. Don't discard/delete anything. When you are actually documenting things, make sure all the notes you have made are checked for inclusion.
+
+## Acknowledgements
+
+- Big thanks to folks on `developersIndia` and `The Engineerin Org` discord for their inputs.
diff --git a/README.md b/README.md
index 14eb958..a463375 100644
--- a/README.md
+++ b/README.md
@@ -39,7 +39,7 @@
 * [Flutter](#flutter) [**`3`**]
 * [Git](#git) [**`10`**]
 * [Go](#go) [**`15`**]
-* [Meta](#meta) [**`1`**]
+* [Meta](#meta) [**`2`**]
 * [Miscellaneous](#miscellaneous) [**`13`**]
 * [Python](#python) [**`19`**]
 * [Shell](#shell) [**`29`**]
@@ -234,6 +234,7 @@
 ### Meta
 
 <ul>
+<li><a target="_blank" href="https://github.com/Bhupesh-V/til/blob/master/Meta/checklist-documenting-medium-scale-system-architecture.md">Checklist for documenting a medium to large scale system architecture</a>
 <li><a target="_blank" href="https://github.com/Bhupesh-V/til/blob/master/Meta/tech-writing-cookbook.md">Tech Writing Cookbook - Writing tips for you and my future self</a>
 </ul>
 
diff --git a/SUMMARY.md b/SUMMARY.md
index 95e07a9..681767d 100644
--- a/SUMMARY.md
+++ b/SUMMARY.md
@@ -143,6 +143,7 @@
 ## Meta
 
 <ul>
+<li><a href="Meta/checklist-documenting-medium-scale-system-architecture.md">Checklist for documenting a medium to large scale system architecture</a>
 <li><a href="Meta/tech-writing-cookbook.md">Tech Writing Cookbook - Writing tips for you and my future self</a>
 </ul>
 
diff --git a/count.json b/count.json
index 9ba21aa..62ec7b8 100644
--- a/count.json
+++ b/count.json
@@ -1,3 +1,3 @@
 {
- "count": 145
+ "count": 146
 }
\ No newline at end of file
diff --git a/recent_tils.json b/recent_tils.json
index 69c9fc2..13c5b33 100644
--- a/recent_tils.json
+++ b/recent_tils.json
@@ -1,4 +1,12 @@
 [
+ {
+  "title": "Docker image load & save",
+  "url": "https://til.bhupesh.me/devops/docker-image-load-save"
+ },
+ {
+  "title": "Docker multi-platform build using buildx",
+  "url": "https://til.bhupesh.me/devops/docker-multiplatform-build"
+ },
  {
   "title": "Retrieval-Augmented Generation (RAG)",
   "url": "https://til.bhupesh.me/artificial intelligence/retrieval-augmented-generative-rag"
@@ -30,13 +38,5 @@
  {
   "title": "How to motivate and encourage volunteers",
   "url": "https://til.bhupesh.me/community building/how-to-motivate-and-encourage-volunteers"
- },
- {
-  "title": "Inserting NULL wherever possible on Postgres",
-  "url": "https://til.bhupesh.me/databases/inserting-null-everywhere"
- },
- {
-  "title": "Fundamentals of LLMs",
-  "url": "https://til.bhupesh.me/artificial intelligence/fundamentals-of-llms"
  }
 ]
\ No newline at end of file