CB-6022: Add backwards-compatibility notes to doc

Also change "URI" and "path" references to "URL" where appropriate for consistency.