| FazBrowse GitHub Viewer | Trending | | Home |
| Tools: [Download Repo ZIP] [Original HTTPS Page] |
Sorry, something went wrong.
There was a problem hiding this comment.
Updates the single-animal documentation to use more consistent MyST/Sphinx-friendly formatting (admonitions, images/figures, headings) and improves navigability via an in-page contents block and reorganized sections.
Changes:
Copilot reviewed 3 out of 3 changed files in this pull request and generated 6 comments.
| File | Description |
|---|---|
| docs/UseOverviewGuide.md | Updates links pointing to the single-animal guide. |
| docs/standardDeepLabCut_UserGuide.md | Major MyST formatting refresh: contents block, directive-based images, admonitions, and section restructuring. |
| docs/gui/PROJECT_GUI.md | Adds an {important} note about Windows admin terminal usage. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Sorry, something went wrong.
|
|
||
| The user can use the *Load Video* button to load one of the videos in the project configuration file, use the scroll | ||
| bar to navigate across the video and *Grab a Frame* (or a range of frames, as of version 2.0.5) to extract the frame(s). | ||
| bar to navigate across the video and grab a frame or a range of frames to extract the frame(s). |
There was a problem hiding this comment.
Note to self: the napari plugin extraction does not support ranges. Should be added.
Sorry, something went wrong.
|
Thanks for the further updates @deruyter92 |
Sorry, something went wrong.
There was a problem hiding this comment.
Great changes, thanks! Can't approve as it is my own PR, but looks good.
Sorry, something went wrong.
Improve user documentation for the GUI and CLI flows: add an important note to always run the terminal as administrator on Windows, rename and rephrase GUI/CLI headings for clarity, and break out stepwise startup instructions. Restructure the create_new_project section with a concise list of required and optional arguments, add a note explaining symbolic links and why Windows requires admin privileges, include a code example and tip block, and fix Windows path formatting. Minor wording and formatting tweaks throughout to improve readability.
Convert the single-animal user guide to MyST-friendly markdown and improve layout and clarity. Changes include: add a table-of-contents directive; replace raw HTML <img>/<p> blocks with MyST image directives and metadata; introduce admonitions (important/note/caution/hint) for critical points; restructure the project directory section into bulleted lists and an ASCII tree; clarify Windows path guidance and config.yaml parameter notes; normalize API Docs headings and other formatting fixes. These are documentation/formatting updates to improve rendering and readability—no functional code changes.
Update documentation for the single-animal user guide: convert local link refs to file:single-animal-userguide, fix napari link formatting, and reorganize/clarify many sections in standardDeepLabCut_UserGuide.md. Added consistent subsection headings (Overview, Code example, Output, etc.), separators, code block language annotations, a schematic of the training dataset layout, and improved wording/indentation for lists and examples. Also updated UseOverviewGuide.md to point to the revised single-animal guide. These changes improve readability, provide clearer examples, and make the workflow steps and outputs easier to follow.
Minor documentation cleanup in docs/standardDeepLabCut_UserGuide.md: split the conda activation into its own numbered step, simplify wording and line breaks for clarity, and remove bold all-caps headings (OVERVIEW and MODEL COMPARISON) in favor of normal sentences. Purely editorial changes; no functional code changes.
Reorganize the project directory section in the user guide: move the sentence about where outputs are stored to follow the directory tree block and adjust list numbering for the subdirectory descriptions for clarity. Replace Markdown-style links to the napari-deeplabcut docs with Sphinx {ref} roles in two places and clean up minor whitespace/formatting.
Miscellaneous documentation fixes and clarifications across the user guide: - Grammar/wording fixes (e.g. "training and testing set", other minor edits). - Rename config option reference: numframes2extract -> numframes2pick. - Update napari-deeplabcut docs reference to RST cross-reference style. - Rework Optional labels section for clearer phrasing and line breaks. - Adjust networks paragraph spacing and wording. - Reformat dynamic-cropping docs: use triple-quoted string, change "triple" -> "tuple", correct "detectiontreshold" -> "detectionthreshold", and move explanatory text outside the code block for readability. - Update Filter Pose Data: note output used by create_labeled_video (was create_labeled_data) and plot trajectories. - Minor improvements to Plot Trajectories section wording and spacing. - Clarify SkeletonBuilder usage: call deeplabcut.SkeletonBuilder(config_path) and explain config_path. These edits are documentation-only and improve readability, accuracy, and consistency.
Rewrite and reorganize project subdirectory documentation for clarity: convert prose into numbered sections for dlc-models/dlc-models-pytorch, labeled-data, training-datasets, and videos; clarify iteration/shuffle/train/test structure, YAML config files, and checkpoint usage; note copy_videos behavior (default False). Update napari labeling section to use a hint block linking to napari docs and remove the inline HOT KEYS block (left commented out). Minor wording tweaks for the optional-labels and label-checking guidance.
Apply editorial fixes to the standard DeepLabCut user guide: correct spelling (e.g., "docstrings"), standardize capitalization for PyTorch and TensorFlow, unify dataset/data set usage, fix punctuation and spacing (e.g., video path, SkeletonBuilder call), and normalize list capitalization. These changes improve readability and consistency across the documentation.
Replace markdown-style links with Sphinx {ref} cross-reference roles in docs/UseOverviewGuide.md and docs/maDLC_UserGuide.md to ensure proper Sphinx rendering. Also fix a malformed bracket/URL in docs/pytorch/architectures.md for the Ye et al. citation link.
| Back | FazBrowse Home | New Git URL |
Motivation
The single animal guide has some older formatting present that could be improved in order to help navigation in the document, and better focus the attention of users on important concepts.
Scope
Refreshes the guide's format to be more MyST-like, more consistent, and provide better navigation with a contents table and working links, as well as more bullet lists and consistent section headers throughout.
TODO