Improve Documentation in README.md

[ohtaman]

Enhance clarity on parameters and return values of the sort_items method. Add a section on testing and how to run tests. Expand contribution guidelines to include coding standards and setup instructions. Include more diverse usage examples.