Normalize error sections in DOM

[nielsdos]

Many DOM error section just list the constant for the $code for DOMException, but don't actually say anywhere that it's a DOMException being thrown.

Although it should still be clear that for the old DOM classes, one can use DOMElement::$strictErrorChecking to make it work with warnings instead.

[ypoleto]

Hey, Is there an example of error section with the problem?

[nielsdos]

Hi

If we take a look at this manual page https://www.php.net/manual/en/domcharacterdata.substringdata.php under the "Errors/Exceptions" section it says:

DOM_INDEX_SIZE_ERR

Raised if offset is negative or greater than the number of 16-bit units in data, or if count is negative.

However, it's not clear that this is a code within the DOMException class.
Annoyingly, the old DOM classes also allow to use warnings instead of exceptions, so this does not always throw and it depends on how the document was configured.
I'm not too sure myself how to clearly document this.

[ypoleto]

I want to start this issue but I'm not very sure about how to start, do you have any ideas?

[Girgias]

I don't think this is the best issue to start working on the documentation. I would recommend looking at one of the other Good First Issues to get familiar with the documentation conventions and the build process.