Refactor: scheduler: best practices for allocate() method

Rename allocate() method to assign() to avoid confusion with memory allocation,
and add a doxygen block.