Documentation of `score()`

[nikosbosse]

Sam flagged an issue with the documentation of score() when reviewing #344.
This issue is a reminder to check this is resolved later on (new documentation was introduced in #375).

[nikosbosse]

@seabbs Closing this for now. Please reopen if you feel the documentation should be updated