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

Updated docs #206

Open
wants to merge 3 commits into
base: master
Choose a base branch
from
Open

Updated docs #206

wants to merge 3 commits into from

Conversation

UnravelSports
Copy link
Contributor

Hi!

As per #205 I have made an initial attempt at improving some of the documentation. An overview of the changes are:

  • Split Getting-started into Event and Tracking data sub categories.
  • Moved Getting-started and Examples under Tutorials section.
  • Created a Functionality segment that includes:
    • Provider overview (including updated Tracking data providers).
    • Event function overview with all event data provider functionality, arguments and returns listed including explanation and reference to the coordinate-systems page.
    • Tracking same as Event, but for tracking data functionality
    • Coordinate-Systems that lists all options for "coordinates" including the pitch dimensions, origin and orientation.
  • A small update to Other/Contributing to make it easier to find how to contribute to the docs.

I'm creating this initial Pull Request to see if I'm on the right track and to potentially discuss how to segment the docs going forward.

### DataFactory

#### load
`kloppy.kloppy._providers.datafactory.load(event_data, event_types=None, coordinates=None, event_factory=None)`
Copy link
Contributor

Choose a reason for hiding this comment

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

Is it possible to generate event-data.md and tracking-data.md from code? And if not, please make sure the function call looks like kloppy.datafactory.load. We try to hide the _providers module from the end-users.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

It's not generated from code. And yes, good point. I'll update that.

- [Metrica](#metrica)
- [Opta](#opta)
- [Sportec](#sportec)
- [SportsCode](#sportscode)
Copy link
Contributor

Choose a reason for hiding this comment

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

SportsCode isn't event data. It's a separate category.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

What do you recon this category should be called?

@koenvo
Copy link
Contributor

koenvo commented Jul 29, 2023

The new structure looks good to me.

@koenvo
Copy link
Contributor

koenvo commented Sep 20, 2023

@UnravelSports can you give a status update?

@UnravelSports
Copy link
Contributor Author

Status update: I have not done any more work on this, unfortunately.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants