Skip to content

Update the documentation to remove deprecated features#1840

Merged
gdlg merged 9 commits intodevelopfrom
gppayend/docs
Aug 27, 2025
Merged

Update the documentation to remove deprecated features#1840
gdlg merged 9 commits intodevelopfrom
gppayend/docs

Conversation

@gdlg
Copy link
Copy Markdown
Contributor

@gdlg gdlg commented Aug 22, 2025

Summary

This PR updates the documentation to remove deprecated features. I have fixed the documentation of the download command which was outdated. I have also added a new "kaggle" extras dependency group to install the correct dependencies for downloading from Kaggle. I also fixed the description of some commands and well as some error messages.

I also disabled the git-check pre-commit because it conflicts with .rst files and I couldn’t find a way to ignore those; we can re-enable it if we find a better way.

How to test

Checklist

  • I have added unit tests to cover my changes.​
  • I have added integration tests to cover my changes.​
  • I have added the description of my changes into CHANGELOG.​
  • I have updated the documentation accordingly

License

  • I submit my code changes under the same MIT License that covers the project.
    Feel free to contact the maintainers if that's a concern.
  • I have updated the license header for each file (see an example below).
# Copyright (C) 2025 Intel Corporation
#
# SPDX-License-Identifier: MIT

gdlg added 4 commits August 26, 2025 23:51
Signed-off-by: Grégoire Payen de La Garanderie <gregoire.payen.de.la.garanderie@intel.com>
Signed-off-by: Grégoire Payen de La Garanderie <gregoire.payen.de.la.garanderie@intel.com>
Signed-off-by: Grégoire Payen de La Garanderie <gregoire.payen.de.la.garanderie@intel.com>
Signed-off-by: Grégoire Payen de La Garanderie <gregoire.payen.de.la.garanderie@intel.com>
…les.

Signed-off-by: Grégoire Payen de La Garanderie <gregoire.payen.de.la.garanderie@intel.com>
…les.

Signed-off-by: Grégoire Payen de La Garanderie <gregoire.payen.de.la.garanderie@intel.com>
@gdlg gdlg requested a review from AlbertvanHouten August 27, 2025 08:19
- Compute dataset statistics
```console
datum stats -p <path/to/project/>
datumaro stats /path/to/dataset:coco
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

The previous files in this PR all use datum as the command name. Why is this one different?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Good catch, I have battled pretty hard with Copilot to avoid it doing this change. The issue is that the Python package is called datumaro and when calling the CLI help using Python (i.e. python -m datumaro convert --help), the first line says Usage: datumaro convert ... which is really confusing.

I am almost thinking of renaming the CLI to datumaro instead of datum to resolve the confusion. Anyway, for now, I have reverted it.

gdlg added 2 commits August 27, 2025 10:41
Signed-off-by: Grégoire Payen de La Garanderie <gregoire.payen.de.la.garanderie@intel.com>
@gdlg gdlg merged commit b3cfed9 into develop Aug 27, 2025
16 checks passed
@gdlg gdlg deleted the gppayend/docs branch August 28, 2025 09:55
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.

2 participants