Documentation: New error handling Deprecated Classes and Functions

[fkeijzer]

Related to #1722

[GaryJones]

Are the valid and invalid examples correct here?

I see different parameter names in the examples, but the description is about values.

In this case, it should be string values that are used, not variable names:

Valid:

bloginfo( 'url' );
$tagline = get_bloginfo( 'description' );

Invalid:

bloginfo( 'siteurl' );
$home_url = get_bloginfo( 'home' );

These examples also then include indicators that it applies to bloginfo() and get_bloginfo().

Please also see the other comments.

[GaryJones]

A few more changes please.

[jrfnl]

FYI: @fkeijzer and me have sat down together at WordCamp Nijmegen today to review this.

The changes I've pushed now in the second commit have been made by us together.

@GaryJones Would you like to do one last look over ? (and merge if deemed ok)

Superseded