Skip to content

fix file docs, add audiofile#1589

Merged
shcheklein merged 1 commit intomainfrom
document-audio-file
Feb 16, 2026
Merged

fix file docs, add audiofile#1589
shcheklein merged 1 commit intomainfrom
document-audio-file

Conversation

@shcheklein
Copy link
Contributor

Add some missing docs, remove public docs from old, ugly stuff that we should really remove.

@cloudflare-workers-and-pages
Copy link

cloudflare-workers-and-pages bot commented Feb 14, 2026

Deploying datachain with  Cloudflare Pages  Cloudflare Pages

Latest commit: 52719d0
Status: ✅  Deploy successful!
Preview URL: https://b14bf192.datachain-2g6.pages.dev
Branch Preview URL: https://document-audio-file.datachain-2g6.pages.dev

View logs

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR adds missing documentation to the File class methods and creates comprehensive documentation for AudioFile, similar to existing ImageFile and VideoFile documentation.

Changes:

  • Added docstrings to several File class methods (upload, at, name, parent, ensure_cached)
  • Removed public documentation from internal methods (get_file_ext, get_file_stem, get_uri, get_fs_path, get_fs) that are implementation details
  • Created new AudioFile documentation page following the established pattern for data type documentation
  • Fixed incorrect VideoFile link in the references index (was pointing to imagefile.md instead of videofile.md)

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated no comments.

File Description
src/datachain/lib/file.py Added docstrings with Args/Returns/Examples for upload, at, name, parent, ensure_cached, and rebase methods; removed docstrings from internal methods
mkdocs.yml Added AudioFile to the navigation menu under data types
docs/references/index.md Fixed VideoFile link and added AudioFile to the data types list
docs/references/data-types/audiofile.md New comprehensive documentation page for AudioFile following the pattern of ImageFile and VideoFile docs

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@codecov
Copy link

codecov bot commented Feb 14, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@shcheklein shcheklein merged commit 2b2ce79 into main Feb 16, 2026
42 checks passed
@shcheklein shcheklein deleted the document-audio-file branch February 16, 2026 17:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants