Comments from ahalle and tmathern

Author: crandmck

docs/tasks/includes/_python-get-resources.md

@@ -7,14 +7,14 @@ _NOTE: Need to add example of using `reader.resource_to_stream()`._
 
 ```py
 try:
-  # Create a reader from a file path
+  # Create a reader from a file path.
   reader = c2pa.Reader.from_file("path/to/media_file.jpg")
 
   # Get the active manifest.
   manifest = reader.get_active_manifest()
   if manifest != None:
 
-    # get the uri to the manifest's thumbnail and write it to a file
+    # get the uri to the manifest's thumbnail and write it to a file.
     uri = manifest["thumbnail"]["identifier"]
     reader.resource_to_file(uri, "thumbnail_v2.jpg") 
 

docs/tasks/includes/_python-read.md

@@ -7,10 +7,10 @@ An asset file may contain many manifests in a manifest store. The most recent ma
 
 ```py
 try:
-  # Create a reader from a file path
+  # Create a reader from a file path.
   reader = c2pa.Reader.from_file("path/to/media_file.jpg")
 
-  # Alternatively, create a reader from a stream
+  # Alternatively, create a reader from a stream.
   stream = open("path/to/media_file.jpg", "rb")
   reader = c2pa.Reader("image/jpeg", stream)
 

docs/tasks/includes/_python-setup.md

@@ -1,21 +1,21 @@
 This is how to set up your code to use the Python library.
 
 ```python
-# Import the C2PA Python package
+# Import the C2PA Python package.
 from c2pa import *
 
-# Import standard general-purpose packages
+# Import standard general-purpose packages.
 import os
 import io
 import logging
 import json
 import base64
 
-# Import web packages used in example implementation
+# Import web packages used in example implementation.
 from flask import Flask, request, abort
 from flask_cors import CORS
 from waitress import serve
 
-# Import AWS SDK package (to use KMS)
+# Import AWS SDK package (to use KMS).
 import boto3
 ```

docs/tasks/includes/_rust-read.md

@@ -18,8 +18,8 @@ Use [`from_stream`](https://docs.rs/c2pa/latest/c2pa/struct.Reader.html#method.f
 
 ```rust
 use std::io::Cursor;
-
 use c2pa::Reader;
+
 let mut stream = Cursor::new(include_bytes!("../tests/fixtures/CA.jpg"));
 let reader = Reader::from_stream("image/jpeg", stream).unwrap();
 println!("{}", reader.json());

docs/tasks/includes/_rust-setup.md

@@ -1,5 +1,9 @@
 This is how to setup your code to use the Rust library.
 
+:::tip
+The files used in this example are in the C2PA Rust library [`sdk/tests/fixtures`](https://github.com/contentauth/c2pa-rs/tree/main/sdk/tests/fixtures) directory.
+:::
+
 ```rust
 use std::{
     io::{Cursor, Write},
@@ -8,7 +12,6 @@ use std::{
 
 use anyhow::Result;
 use c2pa::{settings::load_settings_from_str, Builder, CallbackSigner, Reader};
-
 use c2pa_crypto::raw_signature::SigningAlg;
 use serde_json::json;