Change docupdates (#130)

* getting rustfmt happy
* adding surrounding documentation and curation to add Change into the overall docs

Sources/Automerge/Automerge.docc/Automerge.md

@@ -84,6 +84,7 @@ Read <doc:FiveMinuteQuickstart> to get a quick taste of how to use Automerge, or
 
 - <doc:ChangesAndHistory>
 - ``Automerge/ChangeHash``
+- ``Automerge/Change``
 - ``Automerge/Patch``
 - ``Automerge/PatchAction``
 - ``Automerge/PathElement``

Sources/Automerge/Automerge.docc/Curation/Change.md

@@ -0,0 +1,17 @@
+# ``Automerge/Change``
+
+## Topics
+
+### Inspecting a Change
+
+- ``Change/hash``
+- ``Change/actorId``
+- ``Change/deps``
+- ``Change/bytes``
+- ``ChangeHash/debugDescription``
+
+### Inspecting Change Metadata
+
+- ``Change/message``
+- ``Change/timestamp``
+

Sources/Automerge/Automerge.docc/Curation/Document.md

@@ -74,6 +74,7 @@
 
 - ``heads()``
 - ``getHistory()``
+- ``change(hash:)``
 
 ### Reading historical map values
 
@@ -100,6 +101,7 @@
 ### Saving, forking, and merging documents
 
 - ``save()``
+- ``commitWith(message:timestamp:)``
 - ``encodeNewChanges()``
 - ``encodeChangesSince(heads:)``
 - ``applyEncodedChanges(encoded:)``

Sources/Automerge/Change.swift

@@ -3,12 +3,19 @@ import Foundation
 
 typealias FfiChange = AutomergeUniffi.Change
 
+/// A type that encapsulates a change, and any associated metadata, to an Automerge document.
 public struct Change: Equatable {
+    /// The identity of the actor that made the change.
     public let actorId: ActorId
+    /// An optional message associated with the change.
     public let message: String?
+    /// The list of changes that this change depends upon.
     public let deps: [ChangeHash]
+    /// The timestamp of the change.
     public let timestamp: Date
+    /// The encoded bytes of the change operation.
     public let bytes: Data
+    /// The identity of the change, its hash.
     public let hash: ChangeHash
 
     init(_ ffi: FfiChange) {

rust/src/doc.rs

@@ -8,7 +8,7 @@ use crate::actor_id::ActorId;
 use crate::mark::{ExpandMark, Mark};
 use crate::patches::Patch;
 use crate::{
-    Change, ChangeHash, Cursor, ObjId, ObjType, PathElement, ScalarValue, SyncState, Value
+    Change, ChangeHash, Cursor, ObjId, ObjType, PathElement, ScalarValue, SyncState, Value,
 };
 
 #[derive(Debug, thiserror::Error)]