Skip to content

Improve README documentation with clearer usage instructions#9

Open
Asadp3406 wants to merge 1 commit intoML4SCI:mainfrom
Asadp3406:improve-readme-usability
Open

Improve README documentation with clearer usage instructions#9
Asadp3406 wants to merge 1 commit intoML4SCI:mainfrom
Asadp3406:improve-readme-usability

Conversation

@Asadp3406
Copy link

Improve README Documentation for Better Usability

Fixes #7

Changes Made

This PR significantly improves the documentation across all project READMEs to help new contributors reproduce workflows more easily:

Main README (README.md)

  • Added comprehensive troubleshooting section with common issues
  • Enhanced prerequisites with system requirements table
  • Added runtime estimates and expected outputs
  • Included project-specific troubleshooting matrix

Individual Project READMEs

  1. Non-local Jet Classification - Created complete README from scratch

    • Added project overview and dataset description
    • Included installation instructions and dependencies
    • Added multiple usage options (script, notebook, preprocessing)
    • Documented project structure and key features
  2. Graph Representation Learning - Major enhancement

    • Added detailed installation troubleshooting
    • Included runtime estimates and performance tips
    • Added configuration options and expected results
    • Enhanced troubleshooting section with specific solutions
  3. Physics-Informed Neural Networks - Restructured for clarity

    • Reorganized content with clear sections and emojis
    • Added quick start guide with multiple options
    • Included expected results and success indicators
    • Enhanced project structure documentation

🧪 Testing

  • Verified all markdown formatting renders correctly
  • Checked that all internal links work
  • Ensured consistency in structure across projects
  • Validated that instructions are clear and actionable

📋 Checklist

  • No code changes (documentation only)
  • Consistent formatting across all READMEs
  • Added troubleshooting for common issues
  • Included runtime estimates and system requirements
  • Enhanced usability for new contributors

This addresses the need for clearer usage and execution instructions mentioned in issue #7, making it much easier for new contributors to get started with any of the GENIE projects.

- Add comprehensive README for Non_local_Jet_Classification project
- Enhance Graph_Representation_Learning README with detailed setup and troubleshooting
- Restructure Physics_Informed_NN README for better readability
- Add troubleshooting section to main README with common issues and solutions
- Include runtime estimates, expected outputs, and performance tips
- Standardize README structure across all projects for consistency

Addresses issue ML4SCI#7: Improve README with clearer usage and execution instructions
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Improve README with clearer usage and execution instructions

1 participant