Skip to content
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

DOC: Add glossary to the documentation #27019

Open
datapythonista opened this issue Jun 24, 2019 · 2 comments
Open

DOC: Add glossary to the documentation #27019

datapythonista opened this issue Jun 24, 2019 · 2 comments
Labels
Docs Needs Discussion Requires discussion from core team before further action

Comments

@datapythonista
Copy link
Member

datapythonista commented Jun 24, 2019

We often use terms in the documentation that may not be clear for the users. For example:

scikit-learn added a glossary to their documentation (https://scikit-learn.org/stable/glossary.html), and I think this would also be useful for pandas. Not sure the exact terminology to start with, but feel free to comment here with your ideas, and we can work on this once we have a first list.

@datapythonista datapythonista added Docs Needs Discussion Requires discussion from core team before further action labels Jun 24, 2019
@TomAugspurger
Copy link
Contributor

My main concern here is duplication of information. Hopefully we could pair adding a glossary with a cleanup of existing definitions.

A few other terms that may be worth having entries for.

  • alignment
  • dtype
  • missing value / missing data (we already have a section for this)
  • extension array
  • method chaining
  • offset (time series)

@WillAyd
Copy link
Member

WillAyd commented Jun 24, 2019

Throwing a few more into the ring for consideration:

  • Datetime-like
  • Arraylike
  • Path or Buffer
  • Numeric (or at least mention this doesn't include Decimal)

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

3 participants