bugfix: fix markdown link references and add more notes (#24)

* notes: fix links for real
mtrsk · Oct 10, 2024 · 44b4acc · 44b4acc
1 parent b593e63
commit 44b4acc
Show file tree

Hide file tree

Showing 25 changed files with 295 additions and 77 deletions.
diff --git a/README.org b/README.org
@@ -24,5 +24,13 @@ run
 ** Org Roam
 
 The org roam graph generation is a modification from [[https://hugocisneros.com/blog/my-org-roam-notes-workflow/][Hugo Cisnero's Notes
-Workflow]].
+Workflow]]. You can generate the current graph from you local database instance by running:
+
+#+BEGIN_SRC shell
+  graph
+  # or
+  just graph
+#+END_SRC
+
+inside the Nix shell.
 
diff --git a/content-org/content.org b/content-org/content.org
@@ -120,6 +120,61 @@ This is the place where I dump my [[https://www.orgroam.com/][Org ROAM]] notes.
 
 #+RESULTS: export-notes
 
+** Relational Theory
+:PROPERTIES:
+:EXPORT_FILE_NAME: relational-theory
+:EXPORT_DATE: 2024-10-09
+:EXPORT_HUGO_CUSTOM_FRONT_MATTER: :slug relational-theory
+:CUSTOM_ID: relational-theory
+:END:
+
+#+INCLUDE: "../notes/20241009215607-relational_theory.org"
+
+
+** Management
+:PROPERTIES:
+:EXPORT_FILE_NAME: management
+:EXPORT_DATE: 2024-10-09
+:EXPORT_HUGO_CUSTOM_FRONT_MATTER: :slug management
+:CUSTOM_ID: management
+:END:
+
+#+INCLUDE: "../notes/20241009203936-management.org"
+
+
+** The Two Generals Problem
+:PROPERTIES:
+:EXPORT_FILE_NAME: the-two-generals-problem
+:EXPORT_DATE: 2024-10-09
+:EXPORT_HUGO_CUSTOM_FRONT_MATTER: :slug the-two-generals-problem
+:CUSTOM_ID: the-two-generals-problem
+:END:
+
+#+INCLUDE: "../notes/20241009131720-the_two_generals_problem.org"
+
+
+** Immutable Architectures
+:PROPERTIES:
+:EXPORT_FILE_NAME: immutable-architectures
+:EXPORT_DATE: 2024-10-09
+:EXPORT_HUGO_CUSTOM_FRONT_MATTER: :slug immutable-architectures
+:CUSTOM_ID: immutable-architectures
+:END:
+
+#+INCLUDE: "../notes/20241009115044-immutable_architectures.org"
+
+
+** Fallacies Of Distributed Computing
+:PROPERTIES:
+:EXPORT_FILE_NAME: fallacies-of-distributed-computing
+:EXPORT_DATE: 2024-10-09
+:EXPORT_HUGO_CUSTOM_FRONT_MATTER: :slug fallacies-of-distributed-computing
+:CUSTOM_ID: fallacies-of-distributed-computing
+:END:
+
+#+INCLUDE: "../notes/20241009110639-fallacies_of_distributed_computing.org"
+
+
 ** Dializer
 :PROPERTIES:
 :EXPORT_FILE_NAME: dializer
@@ -757,3 +812,4 @@ This is the place where I dump my [[https://www.orgroam.com/][Org ROAM]] notes.
 
 #+INCLUDE: "../notes/20211012215602-kubernetes.org"
 
+
diff --git a/content-org/refs.bib b/content-org/refs.bib
@@ -43,13 +43,30 @@ @book{cesarini2016designing
   publisher={" O'Reilly Media, Inc."}
 }
 
+% C.J. Date
+
+@book{date2007logic,
+  title={Logic and databases: The roots of relational theory},
+  author={Date, Chris J},
+  year={2007},
+  publisher={Trafford Publishing}
+}
+
+@book{date2015sql,
+  title={SQL and relational theory: how to write accurate SQL code},
+  author={Date, Chris J},
+  year={2015},
+  publisher={" O'Reilly Media, Inc."}
+}
+
 @book{date2016type,
   title={Type inheritance and relational theory: subtypes, supertypes, and substitutability},
   author={Date, Chris J},
   year={2016},
   publisher={" O'Reilly Media, Inc."}
 }
 
+% Nix thesis
 @inproceedings{dolstra2001integrating,
   title={Integrating software construction and software deployment},
   author={Dolstra, Eelco},
@@ -90,6 +107,7 @@ @inproceedings{dolstra2008nixos
   year={2008}
 }
 
+% CAP Theorem
 @article{gilbert2002,
   title={Brewer's conjecture and the feasibility of consistent, available, partition-tolerant web services},
   author={Gilbert, Seth and Lynch, Nancy},
@@ -101,6 +119,26 @@ @article{gilbert2002
   publisher={ACM New York, NY, USA}
 }
 
+@article{helland2015immutability,
+  title={Immutability changes everything},
+  author={Helland, Pat},
+  journal={Communications of the ACM},
+  volume={59},
+  number={1},
+  pages={64--70},
+  year={2015},
+  publisher={ACM New York, NY, USA}
+}
+
+% The Two Generals' Problem
+@inproceedings{akkoyunlu1975some,
+  title={Some constraints and tradeoffs in the design of network communications},
+  author={Akkoyunlu, Eralp A and Ekanadham, Kattamuri and Huber, Richard V},
+  booktitle={Proceedings of the fifth ACM symposium on Operating systems principles},
+  pages={67--74},
+  year={1975}
+}
+
 @book{horstman2023effective,
   title={The Effective Manager: Completely Revised and Updated},
   author={Horstman, Mark and Braun, Kate and Sentes, Sarah},
@@ -175,7 +213,7 @@ @article{nemeth2018unix
   year={2018}
 }
 
-@book{perry2020art,
+@book{perry2024art,
     title={The Art of Immutable Architecture},
     author={Perry, Michael L},
     year={2020},

diff --git a/fix-ref-links.py b/fix-ref-links.py
@@ -8,16 +8,16 @@
 MARKDOWN_NOTES = NOTES_DIRECTORY.glob("*.md")
 STATIC_PATH = pathlib.Path("./static").resolve()
 JSON_PATH = pathlib.Path(STATIC_PATH / "graph.json")
-PATTERN = re.compile(r"\[BROKEN\s+LINK:\s+(.+)\]")
+PATTERN = re.compile(r"\[BROKEN\s+LINK:\s+([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12})\]")
 
 with open(JSON_PATH.resolve()) as f:
     graph_list = json.loads(f.read())
 graph = {k["id"].replace("\"", ""):k["lnk"] for k in graph_list["nodes"]}
 
 def rewrite(lnk: str) -> str:
     year = lnk[:4]
-    filename = lnk[15:]
-    title = filename.replace("_", " ").title()
+    filename = lnk[15:].replace("_", "-")
+    title = lnk[15:].replace("_", " ").title()
     return f"[{title}](/notes/{year}/{filename}/)"
 
 def fix_links(path: pathlib.PosixPath) -> None:
@@ -26,7 +26,6 @@ def fix_links(path: pathlib.PosixPath) -> None:
         if len(matches) > 0:
             for item in matches:
                 if item in graph:
-                    #print(rewrite(graph[item]))
                     line = re.sub(PATTERN, rewrite(graph[item]), line, count=1)
         sys.stdout.write(line)
 

diff --git a/flake.nix b/flake.nix
@@ -117,6 +117,7 @@
                   build.exec = "just ci-build";
                   publish.exec = "just public";
                   run.exec = "just ci-run";
+                  graph.exec = "just graph";
                   clean.exec = "just clean";
                 };
 

diff --git a/layouts/partials/graph.html b/layouts/partials/graph.html
diff --git a/notes/20211107141903-the_effective_manager.org b/notes/20211107141903-the_effective_manager.org
@@ -1,7 +1,11 @@
 :PROPERTIES:
 :ID:       32b2fe5a-3bc3-439b-a850-70a539498e9e
 :END:
-#+title: The-Effective-Manager
+#+title: The Effective Manager
+#+HUGO_CATEGORIES: "Management"
+#+HUGO_TAGS: "Books"
+
+Notes from the [cite:@horstman2023effective].
 
 * Teachable and Sustainable Skills
 
@@ -332,3 +336,4 @@ One of your small balls is a big ball to your direct.
 4. Describe the task or project in detail
 5. Address deadline, quality, and reporting standards
 
+#+print_bibliography: 
diff --git a/notes/20211202213813-distributed_systems.org b/notes/20211202213813-distributed_systems.org
@@ -2,54 +2,4 @@
 :ID:       d7efb05f-fb8f-438c-b09d-ea91dc24ebc3
 :END:
 #+title: Distributed Systems
-
-Readings from the following books:
-
-- Michael L. Perry's "The Art of Immutable Architecture".
-
-Properties of a reliable application
-
-+ Idempotence
-+ Immutability
-+ Local Independence
-+ Versioning
-
-* Why Immutable Architecture
-
-#+BEGIN_QUOTE
-..if you are in architecture, you are responsible for cutting the Gordian Knot
-of possible failures and mitigations. This is the fragile process by which we
-build the systems that run our society. 
-#+END_QUOTE
-
-** The Problems with Immutability
-+ It's not how machines actually operate, i.e, we need find a way to represent
-  fixed mutable memory
-+ Modelling mutable actions that need to be solved by our immutable system
-
-** The Fallacies of Distributed Computing
-1. The network is reliable
-2. Latency is zero
-3. Bandwidth is infinite
-4. The network is secure
-5. Topology doesn't change
-6. There is one administrator
-7. Transport cost is zero
-8. The network is homogenous
-
-** Changing Assumptions
-
-#+BEGIN_QUOTE
-The tools that we use and the patterns that we follow today all evolved from a
-time during which assumptions of high reliability, zero latency, and topological
-consistency were not fallacies. (...) When we apply the languages and patterns
-of the past to the problems of modern distributed systems, it is no wonder that
-programmers will make incorrect assumptions.
-#+END_QUOTE
-
-** Structural Sharing
-
-A common optimization for immutable data structures that is enabled by immutable
-data structures.
-
-** The Two Generals' Problem
+#+HUGO_CATEGORIES: "Distributed Systems"
diff --git a/notes/20230411100120-managing_a_programming_project.org b/notes/20230411100120-managing_a_programming_project.org
@@ -1,7 +1,11 @@
 :PROPERTIES:
 :ID:       da4d5031-66cb-4d1c-b8cf-24d12adf5c17
 :END:
-#+title: managing-a-programming-project
+#+title: Managing a Programming Project
+#+HUGO_CATEGORIES: "Management"
+#+HUGO_TAGS: "Books"
+
+Notes from [cite:@metzger1996].
 
 * Introduction
 
@@ -53,3 +57,6 @@ the needs of other systems.
 #+END_QUOTE
 + Interactions
 + Change
+
+
+#+print_bibliography: 
diff --git a/notes/20240711090045-cap_theorem.org b/notes/20240711090045-cap_theorem.org
@@ -5,7 +5,8 @@
 #+HUGO_CATEGORIES: "Distributed Systems"
 #+HUGO_TAGS: "Classic Papers"
 
-First postulated by Eric Brewer in [cite:@brewer2000], and formally proved in [cite:@gilbert2002].
+The CAP Theorem is a classic problem in [[id:d7efb05f-fb8f-438c-b09d-ea91dc24ebc3][Distributed Systems]], first postulated by
+Eric Brewer in [cite:@brewer2000], and formally proved in [cite:@gilbert2002].
 
 * Definitions
 

diff --git a/notes/20240816193136-byzantine_generals_problem.org b/notes/20240816193136-byzantine_generals_problem.org
@@ -3,7 +3,9 @@
 :END:
 #+TITLE: Byzantine Generals Problem
 
-A summary from [cite:@lamport2019byzantine] paper.
+The Byzantine Generals' Problem is an analogy used to describe the difficulties
+of reaching consensus in [[id:d7efb05f-fb8f-438c-b09d-ea91dc24ebc3][Distributed Systems]], this is a summary from
+[cite:@lamport2019byzantine].
 
 * Introduction
 

diff --git a/notes/20240918131408-postgres_subqueries.org b/notes/20240918131408-postgres_subqueries.org
@@ -1,9 +1,9 @@
 :PROPERTIES:
 :ID:       60f014f9-8a82-43b8-ae13-dee68b9470bf
-:EXPORT_HUGO_CATEGORIES: "Databases"
-:EXPORT_HUGO_TAGS: "SQL" "Postgres"
 :END:
 #+title: Postgres Subqueries
+#+HUGO_CATEGORIES: "Databases"
+#+HUGO_TAGS: "SQL" "Postgres"
 
 * Subqueries as Expressions
 

diff --git a/notes/20240921191551-postgres_ctes.org b/notes/20240921191551-postgres_ctes.org
@@ -1,14 +1,12 @@
 :PROPERTIES:
 :ID:       36f5efb2-34da-4d67-8c37-bbd5429d7b55
-:EXPORT_HUGO_CATEGORIES: "Databases"
-:EXPORT_HUGO_TAGS: "SQL" "Postgres"
+:ROAM_ALIASES: CTE
 :END:
 #+title: Postgres CTEs
+#+HUGO_CATEGORIES: "Databases"
+#+HUGO_TAGS: "SQL" "Postgres"
 
 * Common Table Expressions
-:PROPERTIES:
-:ROAM_ALIASES: CTE
-:END:
 
 ** Recursive
 

diff --git a/notes/20240921194441-postgres_functions.org b/notes/20240921194441-postgres_functions.org
@@ -1,9 +1,9 @@
 :PROPERTIES:
 :ID:       32e8ab3c-2b96-410f-b60d-fde9e35b49f3
-:EXPORT_HUGO_CATEGORIES: "Databases"
-:EXPORT_HUGO_TAGS: "SQL" "Postgres"
 :END:
 #+title: Postgres Functions
+#+HUGO_CATEGORIES: "Databases"
+#+HUGO_TAGS: "SQL" "Postgres"
 
 * Functions
 #+BEGIN_SRC plpgsql

diff --git a/notes/20240921194608-postgres_indexes.org b/notes/20240921194608-postgres_indexes.org
@@ -1,6 +1,6 @@
 :PROPERTIES:
 :ID:       48dd781f-123c-4508-82b5-ac9b05383db4
-:EXPORT_HUGO_CATEGORIES: "Databases"
-:EXPORT_HUGO_TAGS: "SQL" "Postgres"
 :END:
 #+title: Postgres Indexes
+#+HUGO_CATEGORIES: "Databases"
+#+HUGO_TAGS: "SQL" "Postgres"
diff --git a/notes/20240923110122-postgres_window_functions.org b/notes/20240923110122-postgres_window_functions.org
@@ -2,6 +2,8 @@
 :ID:       860f97f8-e41d-480b-881b-203773406990
 :END:
 #+title: Postgres Window Functions
+#+HUGO_CATEGORIES: "Databases"
+#+HUGO_TAGS: "SQL" "Postgres"
 
 * Aggregates