Update to 0.5.0 and refresh docs (#203)

* Update to 0.5.0 and refresh docs

- Bump version from 0.4.1 to 0.5.0
- Add prominent documentation link in README before installation section
- Remove non-existent save_labels_set reference from examples
- Reorganize formats.md to move load_labels_set after save_video
- Move LabelsSet to bottom of model.md for better organization
- Add comprehensive Mermaid class diagram showing data model relationships

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

* Add COCO format to documentation

- Add load_coco to formats.md documentation
- This was implemented in PR #199 but not included in the docs

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

* Add installation instructions from main branch

- Add installation from source (main branch) instructions to README
- Add installation from source instructions to docs homepage
- Organize installation options with clear headings (From PyPI, From source)

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

---------

Co-authored-by: Claude <noreply@anthropic.com>

Author: talmo

README.md

@@ -13,11 +13,22 @@ package that aims to provide functionality for interacting with pose tracking-re
 data structures and file formats with minimal dependencies. This package *does not*
 have any functionality related to labeling, training, or inference.
 
+## Documentation
+
+**📚 [Documentation](https://io.sleap.ai)** - Comprehensive guides and API reference
+
 ## Installation
+
+### From PyPI
 ```
 pip install sleap-io
 ```
 
+### From source (latest version)
+```
+pip install git+https://github.com/talmolab/sleap-io.git@main
+```
+
 For video backend support, install with extras:
 ```
 pip install sleap-io[opencv]  # For OpenCV backend

docs/examples.md

@@ -184,7 +184,7 @@ file_dict = {
 loaded_set = sio.load_labels_set(file_dict)
 ```
 
-**See also:** [`LabelsSet`](model.md#sleap_io.LabelsSet), [`load_labels_set`](formats.md#sleap_io.load_labels_set), [`save_labels_set`](formats.md#sleap_io.save_labels_set)
+**See also:** [`LabelsSet`](model.md#sleap_io.LabelsSet), [`load_labels_set`](formats.md#sleap_io.load_labels_set)
 
 
 ## Re-encode video

docs/formats.md

@@ -8,6 +8,8 @@
 
 ::: sleap_io.save_video
 
+::: sleap_io.load_labels_set
+
 ::: sleap_io.load_slp
 
 ::: sleap_io.save_slp
@@ -24,14 +26,14 @@
 
 ::: sleap_io.save_labelstudio
 
+::: sleap_io.load_coco
+
 ::: sleap_io.load_dlc
 
 ::: sleap_io.load_ultralytics
 
 ::: sleap_io.save_ultralytics
 
-::: sleap_io.load_labels_set
-
 ::: sleap_io.load_skeleton
 
 ::: sleap_io.save_skeleton

docs/index.md

@@ -37,6 +37,8 @@ See [Examples](examples.md) for more usage examples and recipes.
 
 
 ## Installation
+
+### From PyPI
 ```
 pip install sleap-io
 ```
@@ -47,6 +49,11 @@ or
 conda install -c conda-forge sleap-io
 ```
 
+### From source (latest version)
+```
+pip install git+https://github.com/talmolab/sleap-io.git@main
+```
+
 ### Optional Dependencies
 
 For video backend support, install with extras:

docs/model.md

@@ -2,11 +2,93 @@
 
 `sleap-io` implements the core data structures used in SLEAP for storing data related to multi-instance pose tracking, including for annotation, training and inference.
 
+## Class Relationships
+
+The following diagram shows the relationships between the main classes in the `sleap-io` data model:
+
+``` mermaid
+classDiagram
+    class Labels {
+        +List~LabeledFrame~ labeled_frames
+        +List~Video~ videos
+        +List~Skeleton~ skeletons
+        +List~Track~ tracks
+    }
+    
+    class LabeledFrame {
+        +Video video
+        +int frame_idx
+        +List~Instance~ instances
+    }
+    
+    class Instance {
+        +Skeleton skeleton
+        +Track track
+        +PointsArray points
+    }
+    
+    class PredictedInstance {
+        +float score
+        +int tracking_score
+    }
+    
+    class Skeleton {
+        +List~Node~ nodes
+        +List~Edge~ edges
+        +List~Symmetry~ symmetries
+    }
+    
+    class Node {
+        +str name
+    }
+    
+    class Edge {
+        +Node source
+        +Node destination
+    }
+    
+    class Symmetry {
+        +Set~Node~ nodes
+    }
+    
+    class Track {
+        +str name
+    }
+    
+    class Video {
+        +str filename
+        +VideoBackend backend
+    }
+    
+    class LabelsSet {
+        +List~Labels~ labels
+    }
+    
+    Labels "1" *-- "0..*" LabeledFrame : contains
+    Labels "1" *-- "0..*" Video : contains
+    Labels "1" *-- "0..*" Skeleton : contains
+    Labels "1" *-- "0..*" Track : contains
+    
+    LabeledFrame "0..*" --> "1" Video : references
+    LabeledFrame "1" *-- "0..*" Instance : contains
+    
+    Instance "0..*" --> "1" Skeleton : uses
+    Instance "0..*" --> "0..1" Track : belongs to
+    Instance <|-- PredictedInstance : inherits
+    
+    Skeleton "1" *-- "1..*" Node : contains
+    Skeleton "1" *-- "0..*" Edge : contains
+    Skeleton "1" *-- "0..*" Symmetry : contains
+    
+    Edge "0..*" --> "2" Node : connects
+    Symmetry "0..*" --> "2" Node : pairs
+    
+    LabelsSet "1" *-- "1..*" Labels : contains
+```
 
 
-::: sleap_io.Labels
 
-::: sleap_io.LabelsSet
+::: sleap_io.Labels
 
 ::: sleap_io.LabeledFrame
 
@@ -37,3 +119,5 @@
 ::: sleap_io.InstanceGroup
 
 ::: sleap_io.RecordingSession
+
+::: sleap_io.LabelsSet

sleap_io/version.py

@@ -3,4 +3,4 @@
 # Define package version.
 # This is read dynamically by setuptools in pyproject.toml to determine the release
 # version.
-__version__ = "0.4.1"
+__version__ = "0.5.0"