Make the warning about running Ubuntu installation as root slightly more dire.

and reminding everyone to always use buildkit

This was once about standards, but no longer is

The lines I took out are not all inclusive (ie. drush & wp-cli are excluded) - try to repoint to right place rather than re-state

These references were about a division of responsibility between the core team and the api team. There is no valid distinction there anymore

We have a template for how to fix core files to support this hook properly. This commit points people to it.

Add in some more bactics

ref:
https://github.com/civicrm/civicrm-dev-docs/pull/228#discussion_r130018478

ref:
https://github.com/civicrm/civicrm-dev-docs/pull/228#discussion_r130018015

ref:
https://github.com/civicrm/civicrm-dev-docs/pull/228#discussion_r130017573

from:
https://wiki.civicrm.org/confluence/display/CRMDOC/How+to+migrate+or+write+an+api

Direct import with no edits

from:
https://wiki.civicrm.org/confluence/display/CRMDOC/API+Architecture+Standards

Direct import (no modifications).

ref:
https://github.com/civicrm/civicrm-dev-docs/pull/217#issuecomment-314945998

ref:
https://github.com/civicrm/civicrm-dev-docs/pull/217#discussion_r127111272

I tried using this code with the short name and it didn't work.
When I changed my code to use my extension's long name, it worked.