Maintanence: Update README.md to improve DX

[salihgueler]

Description

Updates the README.md files to fix some problems explained at issue #284

Related Issues

#284

Checklist

Before you create this PR confirm that it meets all requirements listed below by checking the relevant checkboxes ([x]).
This will ensure a smooth and quick review process.

• I read the Contributor Guide and followed the process outlined there for submitting PRs.
• My PR includes tests for all changed/updated/fixed behaviors.
• All existing and new tests are passing.
• I updated/added relevant documentation (doc comments with ///).
• The analyzer (melos run analyze) does not report any problems on my PR.
• The package compiles with the minimum Flutter version stated in the pubspec.yaml

Breaking Change

Does your PR require plugin users to manually update their apps to accommodate your change?

• Yes, this is a breaking change.
• No, this is not a breaking change.

[TahaTesser]

Overall, this looks like a idea to me but I'll let @ulusoyca review as I mainly review code format and tests here.

[ulusoyca]

Thanks for this amazing work! Added some suggestions!