Merge pull request #102 from braboj/fix/object-diagram-cleanup

Clean up object model diagram and prose

Author: braboj

assets/drawio/git-object-model.drawio

@@ -59,21 +59,6 @@
           <mxGeometry relative="1" as="geometry" />
         </mxCell>
 
-        <!-- commit → commit (parent) -->
-        <mxCell id="arrow-commit-parent" value="" style="endArrow=classic;html=1;strokeColor=#444441;strokeWidth=1;endFill=1;endSize=6;curved=1;" edge="1" parent="1">
-          <mxGeometry relative="1" as="geometry">
-            <mxPoint x="310" y="200" as="sourcePoint" />
-            <mxPoint x="310" y="200" as="targetPoint" />
-            <Array as="points">
-              <mxPoint x="310" y="160" />
-              <mxPoint x="280" y="160" />
-            </Array>
-          </mxGeometry>
-        </mxCell>
-        <mxCell id="label-parent" value="parent" style="text;html=1;align=center;verticalAlign=middle;fontSize=11;fontColor=#5F5E5A;fontFamily=Helvetica;fontStyle=2;" vertex="1" parent="1">
-          <mxGeometry x="265" y="140" width="50" height="20" as="geometry" />
-        </mxCell>
-
         <!-- commit → tree -->
         <mxCell id="arrow-commit-tree" value="" style="endArrow=classic;html=1;strokeColor=#444441;strokeWidth=1;endFill=1;endSize=6;" edge="1" parent="1" source="commit-card" target="tree-card">
           <mxGeometry relative="1" as="geometry" />

assets/images/git-object-model.png

@@ -214,10 +214,10 @@ Tags are **not** pushed automatically — you must run
 
 ### How Objects Relate
 
-The diagram below shows how objects and references connect. Objects
-(solid arrows) are immutable data stored in `.git/objects/`. References
-(dashed arrows) are named pointers stored in `.git/HEAD` and
-`.git/refs/` that give human-readable names to commits.
+The diagram below shows how the four object types connect. A tag
+points to a commit, a commit points to a root tree, and a tree
+contains blobs (files) and other trees (subdirectories). All objects
+are immutable and stored in `.git/objects/`.
 
 ![Object Model](../assets/images/git-object-model.png)
 

astro-site/src/content/docs/building-blocks.md

@@ -214,10 +214,10 @@ Tags are **not** pushed automatically — you must run
 
 ### How Objects Relate
 
-The diagram below shows how objects and references connect. Objects
-(solid arrows) are immutable data stored in `.git/objects/`. References
-(dashed arrows) are named pointers stored in `.git/HEAD` and
-`.git/refs/` that give human-readable names to commits.
+The diagram below shows how the four object types connect. A tag
+points to a commit, a commit points to a root tree, and a tree
+contains blobs (files) and other trees (subdirectories). All objects
+are immutable and stored in `.git/objects/`.
 
 ![Object Model](../assets/images/git-object-model.png)