Devhub URL Structure to be updated

[siobhan]

The URL structure for devhub should be updated to:

developer.wordpress.org
developer.wordpress.org/reference/
developer.wordpress.org/reference/?s=
developer.wordpress.org/reference/functions/
developer.wordpress.org/reference/function/some_function
developer.wordpress.org/reference/hooks/
developer.wordpress.org/reference/hook/some_hook
developer.wordpress.org/reference/classes/
developer.wordpress.org/reference/class/some_class
developer.wordpress.org/reference/class/some_class/some_method
developer.wordpress.org/reference/source_files/
developer.wordpress.org/reference/source_files/file-name
developer.wordpress.org/reference/versions/
developer.wordpress.org/reference/version/version-number
developer.wordpress.org/resources/
developer.wordpress.org/resources/some_resource (e.g. dashicons)
developer.wordpress.org/blog/
developer.wordpress.org/themes/ (theme dev handbook landing page)
developer.wordpress.org/themes/some-handbook-page/
developer.wordpress.org/plugins/ (plugin dev handbook landing page)
developer.wordpress.org/plugins/some-handbook-page/

[atimmer]

324.diff changes the permalink for functions, classes, hooks and source files.

[coffee2code]

This ticket is kinda old. After in-person discussions just before the devhub launch (as noted by Nacin), Nacin, Siobhan, Otto, and I adapted the URL structure to make them hackable (i.e. remove each URL ending path segment and the URLs would still work).

So rather than switching to the singular for specific items as proposed:

developer.wordpress.org/reference/functions/
developer.wordpress.org/reference/function/some_function
developer.wordpress.org/reference/hooks/
developer.wordpress.org/reference/hook/some_hook
developer.wordpress.org/reference/classes/
developer.wordpress.org/reference/class/some_class
developer.wordpress.org/reference/class/some_class/some_method

We kept the plurals (in all cases):

developer.wordpress.org/reference/functions/
developer.wordpress.org/reference/functions/some_function
developer.wordpress.org/reference/hooks/
developer.wordpress.org/reference/hooks/some_hook
developer.wordpress.org/reference/classes/
developer.wordpress.org/reference/classes/some_class
developer.wordpress.org/reference/classes/some_class/some_method

Other differences:

developer.wordpress.org/reference/source_files/
developer.wordpress.org/reference/source_files/file-name
developer.wordpress.org/reference/versions/
developer.wordpress.org/reference/version/version-number

Are instead:

developer.wordpress.org/reference/files/
developer.wordpress.org/reference/files/file-name
developer.wordpress.org/reference/since/
developer.wordpress.org/reference/since/version-number

As Nacin suggested, we could make the singular versions work as well, simply redirecting to the plural versions.

The final set of URLs can be implemented in conjunction with those sections being implemented:

developer.wordpress.org/resources/some_resource (e.g. dashicons)
developer.wordpress.org/blog/
developer.wordpress.org/themes/ (theme dev handbook landing page)
developer.wordpress.org/themes/some-handbook-page/
developer.wordpress.org/plugins/ (plugin dev handbook landing page)
developer.wordpress.org/plugins/some-handbook-page/

That said, I think the ticket can be closed as fixed, unless there are objections to the existing URL structure?