Action/Generate: Add the PR documentation to `readHaskellHaddock`

The reasoning behind this function was described in its PR message,
but did not make it into documentation.

I opted for just copying it into the docstring for now, maybe later
there could be a better place for it, e.g. in the manual.