(DX) api/v3/examples - Rename *.php to *.ex.php

[totten]

Overview

The api/v3/examples folder contains a large number of files with the same names (Get.php, Create.php, etc).

If you are in an IDE (or non-trivial text-editor) and wish to jump to a file by name (<hotkey> + Get.php), then the uniqueness of the names becomes a factor in usability (DX).

Before

Ex: If you want to jump to any file named Get.php, the list is very long. It includes ~10 code files and ~68 example files.

Anecdotally, I never open any of those ~68 files; I do open the others occasionally, and there's no way to filter down the list further. It's awkward picking the one you want.

After

The example files use the extension *.ex.php, which means that you can easily trim-down the list of autocomplete results (Get vs Get.php vs Get.ex).

[civibot]

(Standard links)

• If this is your first pull-request for CiviCRM, please browse CONTRIBUTING.md for information about the development and testing processes.
• If you are reviewing this pull-request, you may wish to consult the test sites and the Review Standards (long template, short template).

[seamuslee001]

@totten this seems to make sense to me but given that extensions can have their own examples we will probably want to flag this in a change log or similar

[colemanw]

I feel like the examples were sort of a precursor to the api explorer, which goes further than just presenting a static example by generating the code specific to whatever you're trying to do. I'd be curious to know if anyone actually refers to those example files anymore.
I wasn't planning to do anything similar in api4, as it's documented by the explorer, docblocks, and tests.
Which is all to say, sure lets merge this.