Second draft of file bundle adapter docs.

[ssteinbach]

Following conversation with @darbyjohnston, an attempt to clean up and clarify the documentation for the file bundle adpaters.

[codecov-commenter]

Codecov Report

❌ Patch coverage is 90.00000% with 2 lines in your changes missing coverage. Please review.
✅ Project coverage is 81.71%. Comparing base (c0e97b0) to head (6380c80).
⚠️ Report is 77 commits behind head on main.

Files with missing lines	Patch %	Lines
src/py-opentimelineio/opentimelineio/url_utils.py	86.66%	1 Missing and 1 partial ⚠️

❌ Your changes status has failed because you have indirect coverage changes. Learn more about Unexpected Coverage Changes and reasons for indirect coverage changes.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #1709      +/-   ##
==========================================
- Coverage   84.11%   81.71%   -2.41%     
==========================================
  Files         198      176      -22     
  Lines       22241    12316    -9925     
  Branches     4687     3018    -1669     
==========================================
- Hits        18709    10064    -8645     
+ Misses       2610     1711     -899     
+ Partials      922      541     -381     

Flag	Coverage Δ
py-unittests	81.71% <90.00%> (-2.41%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

Files with missing lines	Coverage Δ
...ineio/opentimelineio/adapters/file_bundle_utils.py	71.87% <100.00%> (-0.44%)	⬇️
...py-opentimelineio/opentimelineio/adapters/otiod.py	80.95% <100.00%> (-0.45%)	⬇️
...py-opentimelineio/opentimelineio/adapters/otioz.py	84.61% <100.00%> (-0.39%)	⬇️
src/py-opentimelineio/opentimelineio/url_utils.py	85.18% <86.66%> (ø)

... and 62 files with indirect coverage changes

---

Continue to review full report in Codecov by Sentry.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 5dff8be...6380c80. Read the comment docs.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[darbyjohnston]

Thanks for updating the text, looks good to me.

I'm not super familiar with Python, but it looks like there aren't any functional changes, just documentation and refactoring?

[ssteinbach]

@darbyjohnston correct