API: Rename keyword argument noise to shot_noise

[rrjbca]

Description

In the function schechter_lf rename the keyword argument noise to shot_noise. Breaking API change to be considered for 1.0 release. Requires deprecation warnings before merging. Resolves #478

Checklist

• [x] Follow the Contributor Guidelines
• [ ] Write unit tests
• [x] Write documentation strings
• [x] Assign someone from your working team to review this pull request
• [x] Assign someone from the infrastructure team to review this pull request