Add CustomDist as second level header below Distributions in the API

[ricardoV94]

Description

Right now is tucked away inside Distribution utilities:

We have been pushing for it to be a more common tool, so I would show it immediately one level above. May want to wait for #

[ricardoV94]

Also we should change the code examples to show the use of dist first before custom random and logp examples