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

Add user examples #2

Open
OlivierBinette opened this issue Mar 31, 2022 · 1 comment
Open

Add user examples #2

OlivierBinette opened this issue Mar 31, 2022 · 1 comment
Labels
good first issue Good for newcomers
Milestone

Comments

@OlivierBinette
Copy link
Owner

Create an examples folder structured as follows:

examples/
├─ 1-getting-started.ipynb
├─ 2-interesting-use-case.ipynb
└─ ...

Each python notebook should be numbered and contain a working example of StringCompare's features and usage.

The first notebook, 1-getting-started.ipynb, should walk the user through the installation of the package, the logical structure of the package, and simple examples (kind of like the package README does, but in a bit more detail).

Following notebooks should introduce more advanced features and use cases. For instance, we could cover how to learn the parameters of string comparison functions from data, how to do blocking to speed-up finding close matches, or how to feed string comparisons to a machine learning algorithm for fuzzy string matching. Any working example would be suitable here.

Ideas for specific user examples can be proposed by opening separate Github Issues.

The goal of user examples

There are three main goals to providing user examples in this way:

  1. It provides users with a guide to working with the package and working code as a starting point.
  2. It provides us (the developers) with motivating use cases and a playground on which to experiment with new functionality.
  3. It provides us with a way to test end-to-end workflows involving the use of StringCompare. Formal tests are as simple as using pytest and the testbook package to automatically check that all notebooks run without error.
@OlivierBinette OlivierBinette added the good first issue Good for newcomers label Mar 31, 2022
@OlivierBinette OlivierBinette added this to the Packaging milestone Apr 1, 2022
This was referenced Apr 1, 2022
@OlivierBinette
Copy link
Owner Author

I've added some user examples in the examples folder.

Tests still need to be added.

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

No branches or pull requests

1 participant