Refactor documentation into separate topic articles

- Create Core-Components.md article for fundamental types and APIs
- Create Advanced-Topics.md article for specialized functionality
- Remove nested subheadings (####) from main documentation
- Organize topics into logical groups with dedicated articles
- Improve documentation discoverability and navigation

Author: Kyle-Ye

Sources/OpenAttributeGraph/OpenAttributeGraph.docc/Advanced-Topics.md

@@ -0,0 +1,28 @@
+# Advanced Topics
+
+Advanced features and implementation details for sophisticated use cases.
+
+## Overview
+
+These advanced topics cover specialized functionality and implementation details that are useful for complex scenarios and deep integration with OpenAttributeGraph's reactive system.
+
+## Attribute Bodies
+
+Low-level attribute implementation and visitor patterns for advanced attribute manipulation.
+
+- ``AttributeBodyVisitor`` - Protocol for visiting and inspecting attribute bodies
+- ``ObservedAttribute`` - Attribute wrapper for observing changes in other attributes
+
+## Context Management
+
+Types for managing evaluation contexts and rule execution environments.
+
+- ``RuleContext`` - Context object providing access to rule evaluation state
+- ``AnyRuleContext`` - Type-erased rule context for runtime flexibility
+
+## Type System Support
+
+Utilities for working with external values and memory layout manipulation.
+
+- ``External`` - Wrapper for external values not managed by the attribute graph
+- ``PointerOffset`` - Type-safe pointer arithmetic for nested attribute access

Sources/OpenAttributeGraph/OpenAttributeGraph.docc/Core-Components.md

@@ -0,0 +1,49 @@
+# Core Components
+
+The fundamental building blocks of OpenAttributeGraph's reactive programming system.
+
+## Overview
+
+OpenAttributeGraph provides a comprehensive set of components for building reactive applications. These core components work together to provide automatic dependency tracking, efficient updates, and a clean programming model.
+
+## Attributes
+
+The foundation of the reactive system, providing property wrappers and type-erased access to reactive values.
+
+- ``Attribute`` - The primary property wrapper for reactive values
+- ``AnyAttribute`` - Type-erased attribute for runtime flexibility
+- ``WeakAttribute`` - Weak reference attribute wrapper
+- ``AnyWeakAttribute`` - Type-erased weak attribute
+- ``OptionalAttribute`` - Optional value attribute wrapper  
+- ``AnyOptionalAttribute`` - Type-erased optional attribute
+- ``IndirectAttribute`` - Indirect attribute for complex reference scenarios
+
+## Rules and Transformations
+
+Protocols and types for creating computed attributes that derive their values from other attributes.
+
+- ``Rule`` - Protocol for stateless computed attributes
+- ``StatefulRule`` - Protocol for stateful computed attributes  
+- ``Focus`` - Rule for focusing on part of an attribute's value
+- ``Map`` - Rule for transforming attribute values
+
+## Graph Management
+
+Types that manage the dependency graph and coordinate updates across attributes.
+
+- ``Graph`` - Central coordinator for attribute relationships and updates
+- ``Subgraph`` - Scoped computation context for isolated attribute groups
+
+## Runtime Support
+
+Low-level utilities for type introspection, comparison, and memory management.
+
+- ``Metadata`` - Swift runtime type information and reflection
+- ``compareValues(_:_:mode:)`` - Efficient value comparison across types
+- ``TupleType`` - Runtime support for tuple types and operations
+
+## Debugging and Development
+
+Tools for debugging attribute graphs and monitoring performance.
+
+- ``DebugServer`` - Server for debugging and introspecting attribute graphs

Sources/OpenAttributeGraph/OpenAttributeGraph.docc/Info.plist

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>CFBundleName</key>
+	<string>OpenAttributeGraph</string>
+	<key>CFBundleDisplayName</key>
+	<string>OpenAttributeGraph</string>
+	<key>CDDefaultCodeListingLanguage</key>
+	<string>swift</string>
+</dict>
+</plist>

Sources/OpenAttributeGraph/OpenAttributeGraph.docc/OpenAttributeGraph.md

@@ -1,10 +1,10 @@
 # ``OpenAttributeGraph``
 
-A high-performance reactive programming framework that powers SwiftUI's underlying dependency tracking and update system.
+A high-performance reactive programming framework that powers OpebSwiftUI's underlying dependency tracking and update system.
 
 ## Overview
 
-OpenAttributeGraph is an open source implementation of Apple's private AttributeGraph framework. It provides a reactive programming model built around attributes that automatically track dependencies and efficiently propagate changes through a dependency graph.
+It provides a reactive programming model built around attributes that automatically track dependencies and efficiently propagate changes through a dependency graph.
 
 The framework is designed for high performance and powers the reactive updates that make SwiftUI interfaces responsive and efficient.
 
@@ -16,44 +16,8 @@ The framework is designed for high performance and powers the reactive updates t
 
 ### Core Components
 
-#### Attributes
-- ``Attribute``
-- ``AnyAttribute``
-- ``WeakAttribute``
-- ``AnyWeakAttribute``
-- ``OptionalAttribute``
-- ``AnyOptionalAttribute``
-- ``IndirectAttribute``
-
-#### Rules and Transformations
-- ``Rule``
-- ``StatefulRule``
-- ``Focus``
-- ``Map``
-
-#### Graph Management
-- ``Graph``
-- ``Subgraph``
-
-#### Runtime Support
-- ``Metadata``
-- ``compareValues(_:_:mode:)``
-- ``TupleType``
-
-#### Debugging and Development
-- ``DebugServer``
+- <doc:Core-Components>
 
 ### Advanced Topics
 
-#### Attribute Bodies
-- ``_AttributeBody``
-- ``AttributeBodyVisitor``
-- ``ObservedAttribute``
-
-#### Context Management
-- ``RuleContext``
-- ``AnyRuleContext``
-
-#### Type System Support
-- ``External``
-- ``PointerOffset``
+- <doc:Advanced-Topics>