based on https://chat.civicrm.org/civicrm/pl/etog75icwjywt84sxtw11fumoh

We ha one "Generating a skeletal extension" and one "Add features"

Changed `civix generate:custom-data` to `civix generate:custom-xml` as the former is incorrect. Also corrected grammar in subheading "Extending a subtype".

I'm not sure if this has only come about because of my ineptitude (i.e. whether an Entity would always have the same name as the extension), but I found that I couldn't find the files referred to because my Entity and my Extension had different names.

Would that be bad practice on my part? (it would be good to know as I'm very new to coding)

Either way, I think this may be more accurate... rest is up to you.

Cheers,
M.

Find/replace `(?<=\w) {2,}` with ` `

Reading for content; editing for consistency.

Reorder extensions files and rename to be extension structure to be clear its more than just files its directory strcutre and improve doc a bit

Two recent SE questions have made me think that readers are missing this
key set of installing CiviCRM with civibuild (instead of with the normal
installation steps). I've added clarification here which I hope will
prevent future users from stumbling on this step.

ref:

https://civicrm.stackexchange.com/questions/19294/how-to-create-entity-in-civicrm
https://civicrm.stackexchange.com/questions/19194/unable-to-locate-folder-xml-under-the-civicrm-root-directory

This way MkDocs will be able to report errors for broken links

Done with:

perl -0777 -i -pe \
's@(?<!!)\[([^\]]*)\]\((?!https?://)(?!mailto:)(/(?:(?:(?:/(?![\)#]))|[^/)#])(?!.md))+)/?(#[^)]*)?\)@[$1]($2.md$3)@gm' \
`find . -name '*.md'`

Updated line 627 to "For use with CiviCRM 4.3 and later," per info from @totten

http://www.writethedocs.org/guide/writing/docs-principles/#cumulative
Creating a new entity should come before creating a database upgrader

remove hookref-old.md and move all content into relevant files. Add wordpress setup information for hooks.