Add Box Seeding Documentation to Segmentation Parameter Docs

[freemansw1]

Resolves #399 and adds box seeding to our documentation for segmentation parameters.

Worked on with @RBhupi during the tobathon 2024

• [x] Have you followed our guidelines in CONTRIBUTING.md?
• [x] Have you self-reviewed your code and corrected any misspellings?
• [x] Have you written documentation that is easy to understand?
• [x] Have you written descriptive commit messages?
• [ ] Have you added NumPy docstrings for newly added functions?
• [ ] Have you formatted your code using black?
• [ ] If you have introduced a new functionality, have you added adequate unit tests?
• [ ] Have all tests passed in your local clone?
• [x] If you have introduced a new functionality, have you added an example notebook?
• [x] Have you kept your pull request small and limited so that it is easy to review?
• [x] Have the newest changes from this branch been merged?

[freemansw1]

@harrietgilmour and @w-k-jones, are you available to review this PR within the next week or so?

[github-actions[bot]]

Linting results by Pylint:

Your code has been rated at 8.72/10 (previous run: 8.72/10, +0.00) _{The linting score is an indicator that reflects how well your code version follows Pylint’s coding standards and quality metrics with respect to the tobathon branch. A decrease usually indicates your new code does not fully meet style guidelines or has potential errors.}

[codecov[bot]]

Codecov Report

All modified and coverable lines are covered by tests :white_check_mark:

Comparison is base (ed4c4bf) 56.91% compared to head (333778b) 56.91%.

Additional details and impacted files

```diff @@ Coverage Diff @@ ## tobathon #406 +/- ## ========================================= Coverage 56.91% 56.91% ========================================= Files 20 20 Lines 3440 3440 ========================================= Hits 1958 1958 Misses 1482 1482 ``` | [Flag](https://app.codecov.io/gh/tobac-project/tobac/pull/406/flags?src=pr&el=flags&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=tobac-project) | Coverage Δ | | |---|---|---| | [unittests](https://app.codecov.io/gh/tobac-project/tobac/pull/406/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=tobac-project) | `56.91% <ø> (ø)` | | Flags with carried forward coverage won't be shown. [Click here](https://docs.codecov.io/docs/carryforward-flags?utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=tobac-project#carryforward-flags-in-the-pull-request-comment) to find out more.

:umbrella: View full report in Codecov by Sentry.
:loudspeaker: Have feedback on the report? Share it here.

[harrietgilmour]

@harrietgilmour and @w-k-jones, are you available to review this PR within the next week or so?

Yes no problem. I can do it next week

[freemansw1]

@harrietgilmour and @w-k-jones, are you available to review this PR within the next week or so?

Yes no problem. I can do it next week

Thanks! Trying to be more deliberate with our review requests.

[w-k-jones]

Also the docstring are wrongly formatted for seed_3D_flag in segmentation.py which is causing the API reference to render incorrectly. I can fix that quickly and add it to this PR

[freemansw1]

Thanks @w-k-jones @harrietgilmour !

@w-k-jones what is our policy on documentation-only PRs? We can merge these right into main, right?

[w-k-jones]

Thanks @w-k-jones @harrietgilmour !

@w-k-jones what is our policy on documentation-only PRs? We can merge these right into main, right?

Yes, looks like there's no issues with merging into main so I'm happy for you to do that directly