Improve README documentation and developer experience

[smsnobin77]

This issue tracks several documentation and usability improvements to make the repository more accessible for new users and contributors:

1. No minimal working example in the README for first-time users
2. No expected output shown, so users don't know what to expect
3. No progress feedback during long-running dataset processing
4. No contributor guidelines despite the tool's extensible architecture