Skip to content

#29 - Update documentation to reflect what is being returned by the API - #47

Merged
reckart merged 1 commit into
mainfrom
feature/29-Update-documentation-to-reflect-what-is-being-returned-by-the-API
Aug 1, 2026
Merged

reckart merged 1 commit into
mainfrom
feature/29-Update-documentation-to-reflect-what-is-being-returned-by-the-API

Conversation

@reckart

@reckart reckart commented Aug 1, 2026

Copy link
Copy Markdown
Member

What's in the PR

  • Document that download methods (annotation, document, curation) return raw bytes that may be ZIP archives for multi-file formats, with runtime sniffing guidance
  • Consolidate ZIP-handling examples to single canonical section in formats documentation with working code and performance notes
  • Condense :return: docstrings in adapter interface to defer to documentation instead of hard-coding format examples

How to test manually

  • No specific test procedure

Automatic testing

  • PR includes unit tests

Documentation

  • PR updates documentation

- Document that download methods (`annotation`, `document`, `curation`) return raw bytes that may be ZIP archives for multi-file formats, with runtime sniffing guidance
- Consolidate ZIP-handling examples to single canonical section in formats documentation with working code and performance notes
- Condense `:return:` docstrings in adapter interface to defer to documentation instead of hard-coding format examples
@reckart reckart added this to the 0.4.0 milestone Aug 1, 2026
@reckart reckart self-assigned this Aug 1, 2026
@reckart reckart added the ⭐️ Enhancement New feature or request label Aug 1, 2026
@reckart reckart added this to Kanban Aug 1, 2026
@github-project-automation github-project-automation Bot moved this to 🔖 To do in Kanban Aug 1, 2026
@codecov-commenter

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 95.68%. Comparing base (de2eca0) to head (cbf5ace).

Additional details and impacted files
@@           Coverage Diff           @@
##             main      #47   +/-   ##
=======================================
  Coverage   95.68%   95.68%           
=======================================
  Files          20       20           
  Lines         696      696           
  Branches       44       44           
=======================================
  Hits          666      666           
  Misses         19       19           
  Partials       11       11           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@reckart
reckart merged commit 6b922ec into main Aug 1, 2026
5 checks passed
@reckart
reckart deleted the feature/29-Update-documentation-to-reflect-what-is-being-returned-by-the-API branch August 1, 2026 13:53
@github-project-automation github-project-automation Bot moved this from 🔖 To do to 🍹 Done in Kanban Aug 1, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

⭐️ Enhancement New feature or request

Projects

Archived in project

Development

Successfully merging this pull request may close these issues.

2 participants