User Guide update - Metadata

1) Combined table_data.rst and fields.rst writeups into the one, metadata.
2) Added return types
3) Updated the database index.rst appropriately

Signed-off-by:James L Parry <jim_parry@bcit.ca>