Refactor: scheduler: best practices for pcmk__group_allocate()

Rename pcmkgroup_allocate() to pcmkgroup_assign() for consistency,
declare in library-private header, and improve variable names, comments, and
formatting.