Added parameters to shares method. Updated get method documentation to correctly reflect the current behavior