Skip to content

Conversation

@maximpavliv
Copy link
Contributor

@maximpavliv maximpavliv commented Feb 7, 2025

Part of the updates to the documentation.

The docs_merge branch is an intermediate branch to cross-review changes before opening a PR into pytorch_dlc.

In particular, I review the following doc files:

  • docs/course.md
  • docs/standardDeepLabCut_UserGuide.md
  • docs/Overviewof3D.md
  • docs/deeplabcutlive.md
  • docs/ModelZoo.md
  • docs/recipes/UsingModelZooPupil.md
  • docs/gui/PROJECT_GUI.md
  • docs/quick-start/single_animal_quick_guide.md
  • docs/beginner-guides/manage-project.md
  • docs/beginner-guides/labeling.md
  • docs/beginner-guides/Training-Evaluation.md
  • docs/beginner-guides/video-analysis.md
  • docs/convert_maDLC.md
  • docs/recipes/BatchProcessing.md
  • docs/recipes/DLCMethods.md
  • docs/recipes/ClusteringNapari.md
  • docs/recipes/OpenVINO.md
  • docs/recipes/pose_cfg_file_breakdown.md
  • docs/recipes/publishing_notebooks_into_the_DLC_main_cookbook.md
  • docs/MISSION_AND_VALUES.md
  • docs/Governance.md
  • docs/roadmap.md

Moreover, I copy the fix to build jupyter books locally from niels/docs. This is a temporary commit, it will be picked from niels/docs when combining the changes.

Also, I add additional reference points to docs reviewed in niels/docs to reference here, this will need to be merged.

Also, I introduce a temporary fix to create_pretrained_project() by forcing it to create fake metadata with TensorFlow as backend engine. This will need to be fixed once Pytorch compatibility is added to create_pretrained_project().

I also remove docs/recipes/MegaDetectorDLCLive.md from _toc.yml, since the MegaDetector app is not online anymore.

Finally, I update the .rst files to point to the right methods for correct doctring insertion.

@maximpavliv maximpavliv requested a review from n-poulsen February 7, 2025 15:46
@maximpavliv maximpavliv changed the title Updates to the documentation Updates to the documentation - Maxim Feb 7, 2025
@maximpavliv maximpavliv force-pushed the maxim/pytorch_dlc_docs branch from a99962b to 7431b2d Compare February 7, 2025 17:39
@n-poulsen n-poulsen added documentation documentation updates/comments DLC3.0🔥 labels Feb 7, 2025
Copy link
Contributor

@n-poulsen n-poulsen left a comment

Choose a reason for hiding this comment

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

This review is a WIP

@n-poulsen n-poulsen self-requested a review February 10, 2025 14:36
@maximpavliv maximpavliv force-pushed the maxim/pytorch_dlc_docs branch from 13a1b7a to c7f35c4 Compare February 10, 2025 16:12
@maximpavliv maximpavliv force-pushed the maxim/pytorch_dlc_docs branch from c7f35c4 to edadf52 Compare February 10, 2025 17:13
@maximpavliv maximpavliv force-pushed the maxim/pytorch_dlc_docs branch from edadf52 to db687bf Compare February 10, 2025 17:27
Copy link
Contributor

@n-poulsen n-poulsen left a comment

Choose a reason for hiding this comment

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

LGTM, thanks!

@n-poulsen n-poulsen merged commit e2c2762 into docs_merge Feb 10, 2025
1 check was pending
@n-poulsen n-poulsen deleted the maxim/pytorch_dlc_docs branch February 10, 2025 17:28
MMathisLab added a commit that referenced this pull request Feb 28, 2025
* Updates to the documentation - Maxim (#2869)

* Updates to the docs (#2871)

* add more docs in single animal userguide

* unify train_network docs

* unify train_network docs

* improved augmentation code

* remove link to 3mice TF Colab on homepage

* Update readme and conda env

* Update readme

* docs/pytorch/user_guide Installation: point to docs/installation

* Standardize subtitiles accross single and multi user guides

* Add missing docstring

* improved installation docs

* added quick commands

* improved docs

* install torch and torchvision with pip in the DeepLabCut Conda file

* updated labelling in userguides

* Update DEEPLABCUT.yaml

* install deeplabcut through the pre-release

---------

Co-authored-by: Niels <45132115+n-poulsen@users.noreply.github.com>
Co-authored-by: Niels Poulsen <niels.poulsen@epfl.ch>
Co-authored-by: Mackenzie Mathis <mathis@rowland.harvard.edu>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

DLC3.0🔥 documentation documentation updates/comments

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants