review get_table function

[tbowling87]

check we're happy with the way the function works, the syntax used, the code styling. Make any required changes, add guardian code if needed, checking function arguments for type and other expectations. Add/review roxygen headers