Update documentation

working !

I have updated the README to include detailed sections for installation, configuration, usage, and features.
Also added an AGENTS.md file for AI-related guidance and improved project page content for clarity and completeness.
Please review.

Thanks for the clarification
I have Updated README.md to follow Drupal README template while preserving existing content
Added project-page.html with features and related modules
Ensured existing information is retained and improved for clarity

Please review.

Thanks @aayushpathak for working on this! I took a look at the latest diff. The project-page.html and AGENTS.md look solid, but I just wanted to point out a couple of things:

- The README is still missing the ## INTRODUCTION heading right at the top, which is part of the standard template.
- It looks like the old ## Manage flood table section is still deleted. Like @batigolix mentioned in #7, we should probably keep that original text intact.
- I noticed some changes in tests/src/Kernel/MigrateFloodControlTest.php and ValidateD7MigrationStateTest.php (adding conditionals and phpcs:ignoreFile). Just wondering, is there a specific reason we need to include these test modifications in this documentation issue?

Thanks for the feedback.
I have updated the README.md as discussed to align with the Drupal template, including adding the Introduction section and restoring the original “Manage flood table” content.
I have also reverted the changes made to the test files to keep the scope limited to documentation. Those changes were initially made to address pipeline issues, but I understand they are out of scope for this issue.

Please review the updated patch.

Thanks @aayushpathak for the quick update and for reverting the test files! That keeps the MR nice and clean.

The README is looking much closer to the template now. I just noticed two quick things we need to tweak:

- In the restored "Manage flood table" section, the original step-by-step instructions are still missing. To ensure we don't lose that helpful information (as requested in comment #7), could you append the original ### Steps back into that section?
- Just a minor detail to strictly match the Drupal README template: the main headings are traditionally written in ALL CAPS (e.g., ## INTRODUCTION, ## REQUIREMENTS, ## CONFIGURATION, etc.). Would you mind updating the capitalization of the main headers as well?

Sorry for the confusion and multiple iterations. I have now addressed all the feedback. Please review the updated patch.

I'll take a look at the changes @batigolix

I've reviewed the changes, and everything looks okay too me. @batigolix you can merge this if you want