Skip to content

DOC: Enhance '10 minute to pandas' by providing video walkthrough to help auditory learners and improve accessibility. #59359

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
1 task done
jlr295 opened this issue Jul 30, 2024 · 2 comments
Assignees
Labels
Docs Needs Discussion Requires discussion from core team before further action

Comments

@jlr295
Copy link

jlr295 commented Jul 30, 2024

Pandas version checks

  • I have checked that the issue still exists on the latest versions of the docs on main here

Location of the documentation

https://pandas.pydata.org/pandas-docs/stable/user_guide/10min.html#min

Documentation problem

This documentation does a good job of appealing to those with a reading/writing and visual preferred learning styles (the V and R in education theorist Neil Fleming's VARK student learning model). It even appeals to those Kinesthetic(K) learners as it is modeled like a walk-through where the reader may follow along while reading the guide and dissecting real use-cases. However, this information may be difficult for auditory(A) learners and observational learners. It also may be difficult for neurodivergent learners who have difficulty with reading comprehension and tend to miss important details in text.

Suggested fix for documentation

The addition of a video walkthrough of the '10 minutes to pandas' guide would provide another learning option for those who prefer a non-text based way of learning. This will also promote inclusivity and accessibility, as it will appeal to all learning types as well as users with disabilities.

@jlr295 jlr295 added Docs Needs Triage Issue that has not been reviewed by a pandas team member labels Jul 30, 2024
@WillAyd
Copy link
Member

WillAyd commented Aug 5, 2024

Thanks for the issue. I think the biggest concern with this would be maintaining the video - what is the best way to keep that updated?

@WillAyd WillAyd removed the Needs Triage Issue that has not been reviewed by a pandas team member label Aug 5, 2024
@mroeschke mroeschke added the Needs Discussion Requires discussion from core team before further action label Aug 5, 2024
@imadahmad97
Copy link

imadahmad97 commented Aug 27, 2024

take, can someone clarify where exactly I should commit the video?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Docs Needs Discussion Requires discussion from core team before further action
Projects
None yet
Development

No branches or pull requests

4 participants