-
-
Notifications
You must be signed in to change notification settings - Fork 56.4k
Description
Describe the doc issue
Several tutorials in the OpenCV-Python documentation (located at https://docs.opencv.org/4.x/d6/d00/tutorial_py_root.html) have either the "Additional Resources" or "Exercises" sections (or both) empty. This can lead to incomplete information and potential confusion for readers seeking further guidance or practice opportunities.
Example from tutorial_py_image_arithmetics.html:

Example from tutorial_py_features_meaning.html

I have listed all html pages that have the issue below:
https://docs.opencv.org/4.x/d5/de5/tutorial_py_setup_in_windows.html
https://docs.opencv.org/4.x/dd/dd5/tutorial_py_setup_in_fedora.html
https://docs.opencv.org/4.x/dd/d43/tutorial_py_video_display.html
https://docs.opencv.org/4.x/db/d5b/tutorial_py_mouse_handling.html
https://docs.opencv.org/4.x/d3/df2/tutorial_py_basic_ops.html
https://docs.opencv.org/4.x/d0/d86/tutorial_py_image_arithmetics.html
https://docs.opencv.org/4.x/dc/d71/tutorial_py_optimization.html
https://docs.opencv.org/4.x/df/d9d/tutorial_py_colorspaces.html
https://docs.opencv.org/4.x/da/d6e/tutorial_py_geometric_transformations.html
https://docs.opencv.org/4.x/d4/d13/tutorial_py_filtering.html
https://docs.opencv.org/4.x/d9/d61/tutorial_py_morphological_ops.html
https://docs.opencv.org/4.x/d5/d0f/tutorial_py_gradients.html
https://docs.opencv.org/4.x/dc/dff/tutorial_py_pyramids.html
https://docs.opencv.org/4.x/d4/d73/tutorial_py_contours_begin.html
https://docs.opencv.org/4.x/dd/d49/tutorial_py_contour_features.html
https://docs.opencv.org/4.x/d1/d32/tutorial_py_contour_properties.html
https://docs.opencv.org/4.x/d5/d45/tutorial_py_contours_more_functions.html
https://docs.opencv.org/4.x/d9/d8b/tutorial_py_contours_hierarchy.html
https://docs.opencv.org/4.x/d1/db7/tutorial_py_histogram_begins.html
https://docs.opencv.org/4.x/d5/daf/tutorial_py_histogram_equalization.html
https://docs.opencv.org/4.x/dd/d0d/tutorial_py_2d_histogram.html
https://docs.opencv.org/4.x/dc/df6/tutorial_py_histogram_backprojection.html
https://docs.opencv.org/4.x/de/dbc/tutorial_py_fourier_transform.html
https://docs.opencv.org/4.x/d4/dc6/tutorial_py_template_matching.html
https://docs.opencv.org/4.x/d6/d10/tutorial_py_houghlines.html
https://docs.opencv.org/4.x/da/d53/tutorial_py_houghcircles.html
https://docs.opencv.org/4.x/d8/d83/tutorial_py_grabcut.html
https://docs.opencv.org/4.x/df/d54/tutorial_py_features_meaning.html
https://docs.opencv.org/4.x/dc/d0d/tutorial_py_features_harris.html
https://docs.opencv.org/4.x/d4/d8c/tutorial_py_shi_tomasi.html
https://docs.opencv.org/4.x/da/df5/tutorial_py_sift_intro.html
https://docs.opencv.org/4.x/df/dd2/tutorial_py_surf_intro.html
https://docs.opencv.org/4.x/df/d0c/tutorial_py_fast.html
https://docs.opencv.org/4.x/d1/d89/tutorial_py_orb.html
https://docs.opencv.org/4.x/dc/dc3/tutorial_py_matcher.html
https://docs.opencv.org/4.x/d1/de0/tutorial_py_feature_homography.html
https://docs.opencv.org/4.x/dc/dbb/tutorial_py_calibration.html
https://docs.opencv.org/4.x/d7/d53/tutorial_py_pose.html
https://docs.opencv.org/4.x/da/de9/tutorial_py_epipolar_geometry.html
https://docs.opencv.org/4.x/d4/db1/tutorial_py_svm_basics.html
https://docs.opencv.org/4.x/de/d4d/tutorial_py_kmeans_understanding.html
https://docs.opencv.org/4.x/d1/d5c/tutorial_py_kmeans_opencv.html
https://docs.opencv.org/4.x/d5/d69/tutorial_py_non_local_means.html
Fix suggestion
Remove the empty "Additional Resources" and "Exercises" fields from the affected tutorials to maintain consistency and clarity in the documentation.
All affected markdown files are listed below:
opencv\doc\py_tutorials\py_setup\py_setup_in_windows\py_setup_in_windows.markdown
opencv\doc\py_tutorials\py_setup\py_setup_in_fedora\py_setup_in_fedora.markdown
opencv\doc\py_tutorials\py_gui\py_video_display\py_video_display.markdown
opencv\doc\py_tutorials\py_gui\py_mouse_handling\py_mouse_handling.markdown
opencv\doc\py_tutorials\py_core\py_basic_ops\py_basic_ops.markdown
opencv\doc\py_tutorials\py_core\py_image_arithmetics\py_image_arithmetics.markdown
opencv\doc\py_tutorials\py_core\py_optimization\py_optimization.markdown
opencv\doc\py_tutorials\py_imgproc\py_colorspaces\py_colorspaces.markdown
opencv\doc\py_tutorials\py_imgproc\py_geometric_transformations\py_geometric_transformations.markdown
opencv\doc\py_tutorials\py_imgproc\py_filtering\py_filtering.markdown
opencv\doc\py_tutorials\py_imgproc\py_morphological_ops\py_morphological_ops.markdown
opencv\doc\py_tutorials\py_imgproc\py_gradients\py_gradients.markdown
opencv\doc\py_tutorials\py_imgproc\py_pyramids\py_pyramids.markdown
opencv\doc\py_tutorials\py_imgproc\py_contours\py_contours_begin\py_contours_begin.markdown
opencv\doc\py_tutorials\py_imgproc\py_contours\py_contour_features\py_contour_features.markdown
opencv\doc\py_tutorials\py_imgproc\py_contours\py_contour_properties\py_contour_properties.markdown
opencv\doc\py_tutorials\py_imgproc\py_contours\py_contours_more_functions\py_contours_more_functions.markdown
opencv\doc\py_tutorials\py_imgproc\py_contours\py_contours_hierarchy\py_contours_hierarchy.markdown
opencv\doc\py_tutorials\py_imgproc\py_histograms\py_histogram_begins\py_histogram_begins.markdown
opencv\doc\py_tutorials\py_imgproc\py_histograms\py_histogram_equalization\py_histogram_equalization.markdown
opencv\doc\py_tutorials\py_imgproc\py_histograms\py_2d_histogram\py_2d_histogram.markdown
opencv\doc\py_tutorials\py_imgproc\py_histograms\py_histogram_backprojection\py_histogram_backprojection.markdown
opencv\doc\py_tutorials\py_imgproc\py_transforms\py_fourier_transform\py_fourier_transform.markdown
opencv\doc\py_tutorials\py_imgproc\py_template_matching\py_template_matching.markdown
opencv\doc\py_tutorials\py_imgproc\py_houghlines\py_houghlines.markdown
opencv\doc\py_tutorials\py_imgproc\py_houghcircles\py_houghcircles.markdown
opencv\doc\py_tutorials\py_imgproc\py_grabcut\py_grabcut.markdown
opencv\doc\py_tutorials\py_feature2d\py_features_meaning\py_features_meaning.markdown
opencv\doc\py_tutorials\py_feature2d\py_features_meaning\py_features_meaning.markdown
opencv\doc\py_tutorials\py_feature2d\py_shi_tomasi\py_shi_tomasi.markdown
opencv\doc\py_tutorials\py_feature2d\py_sift_intro\py_sift_intro.markdown
opencv\doc\py_tutorials\py_feature2d\py_surf_intro\py_surf_intro.markdown
opencv\doc\py_tutorials\py_feature2d\py_fast\py_fast.markdown
opencv\doc\py_tutorials\py_feature2d\py_orb\py_orb.markdown
opencv\doc\py_tutorials\py_feature2d\py_matcher\py_matcher.markdown
opencv\doc\py_tutorials\py_feature2d\py_feature_homography\py_feature_homography.markdown
opencv\doc\py_tutorials\py_calib3d\py_calibration\py_calibration.markdown
opencv\doc\py_tutorials\py_calib3d\py_pose\py_pose.markdown
opencv\doc\py_tutorials\py_calib3d\py_epipolar_geometry\py_epipolar_geometry.markdown
opencv\doc\py_tutorials\py_ml\py_svm\py_svm_basics\py_svm_basics.markdown
opencv\doc\py_tutorials\py_ml\py_kmeans\py_kmeans_understanding\py_kmeans_understanding.markdown
opencv\doc\py_tutorials\py_ml\py_kmeans\py_kmeans_opencv\py_kmeans_opencv.markdown
opencv\doc\py_tutorials\py_photo\py_non_local_means\py_non_local_means.markdown