[DOC] - Add custom algorithm example

[TomDonoghue]

Adds a new documentation example on defining and using custom algorithms.

Also adds the following related code updates:

• update print_xx methods to live on each custom object