made the get_key methods more generic
added first examples