Skip to content

docs: improve README with better structure, links, and language annotations#1

Open
loickal wants to merge 5 commits into
mainfrom
feature/unsend
Open

docs: improve README with better structure, links, and language annotations#1
loickal wants to merge 5 commits into
mainfrom
feature/unsend

Conversation

@loickal

@loickal loickal commented Sep 1, 2025

Copy link
Copy Markdown
Owner

📝 Summary

This PR significantly improves the README.md file with better structure, formatting, and user experience enhancements.

✨ Changes Made

🔧 Fixes & Corrections

  • Fixed typo: "wil" → "will" in configuration section
  • Corrected grammar and improved clarity throughout
  • Fixed LICENSE link to point to local file instead of GitHub URL

🏷️ Code Block Improvements

  • Added missing language annotations to all code blocks:
    • typescript for TypeScript examples
    • javascript for JavaScript imports
    • env for environment variable examples
    • sh for shell commands

📋 Structure & Organization

  • Added proper H1 title "useEmail" at the top
  • Removed duplicate Installation section that was misplaced
  • Added emoji headings for better visual hierarchy
  • Reorganized sections in logical order: Features → Providers → Installation → Configuration → Usage
  • Improved heading structure with consistent formatting

🔗 Links & Navigation

  • Added external links to all supported email provider websites
  • Created internal link to EmailOptions section in API Reference
  • Enhanced navigation with proper section linking

💬 User Experience

  • Made wording clearer and more welcoming throughout
  • Enhanced the introduction to be more descriptive
  • Added bullet points with emojis to the Features section
  • Improved section descriptions and instructions
  • Added "Basic Example" subsection for better organization

🎨 Visual Enhancements

  • Added emojis to all major section headings
  • Improved code block formatting and consistency
  • Better organization of import methods section
  • Enhanced overall visual appeal

🎯 Impact

These improvements make the README more:

  • Professional - Clean structure with proper formatting
  • User-friendly - Clear instructions and welcoming tone
  • Navigable - Internal and external links for easy reference
  • Accessible - Better visual hierarchy and organization
  • Accurate - Fixed typos and improved technical accuracy

The README now provides a much better first impression and user experience for developers discovering and using the useEmail library.

@loickal can click here to continue refining the PR

loickal and others added 4 commits August 31, 2025 22:29
…ations

- Fix typos and grammar issues (wil → will)
- Add missing language annotations to all code blocks (typescript, javascript, env, sh)
- Improve README structure with proper H1 title and emoji headings
- Remove duplicate Installation section and reorganize content logically
- Add external links to all supported email provider websites
- Add internal links for better navigation (EmailOptions reference)
- Make wording clearer and more welcoming throughout
- Enhance visual appeal with emojis and better formatting
- Fix LICENSE link to point to local file
@loickal
loickal marked this pull request as ready for review September 1, 2025 13:53
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.

2 participants