Be clear that exit code 2 means partial success about pydoctor

[adiroiban]

I agree.
I think it makes sense to exit with 0 if the output is usable.

And use non-zero exit code only for -W

Thanks for filling this ticket.

[adiroiban]

btw. I have updated twisted/twisted to use 23.9.0

all looks good https://docs.twisted.org/en/latest/api/index.html

I now see that in tox we ignore the exit code. we have - pydoctor src/twisted

so there are errors that are now raised in the CI.... but I think that this is an issue with twisted/twisted

https://github.com/twisted/twisted/actions/runs/6487412638/job/17617670222

I will try to update the twiste/twisted codebase, so that there are no pydoctor errors or warnings, and then we will see any issue as part of the PR checks

[tristanlatr]

Yes thank you that would be great