Handoff checks and details

Handoff.md

Drupal 10 Project Handoff Checklist

Code Quality & Standards

• Clean codebase
  • Remove debug statements
  • Remove commented code
  • Remove unused modules/themes/functions
• Code formatting meets Drupal standards (drupalcs passing)
• JavaScript/TypeScript code follows standards (eslint passing)
• Naming conventions are meaningful and consistent
  • Module names
  • Class names
  • Variable names
  • Function names
• Custom code documentation complete
  • Function parameters and return values
  • Class properties and methods
  • Module hooks and plugins
  • Complex business logic explanations

Documentation

• README.md includes:
  • Project overview and purpose
  • Tech stack and dependencies
  • Local development setup
  • Deployment procedures
  • External service integrations
  • Configuration locations
  • Custom module documentation
  • Content type structure
  • Taxonomy structure

Configuration Management

• Configuration export matches production
• Development configuration properly separated
• Environment-specific settings configured
• Config split/ignore settings verified
• Features and dependencies packaged correctly

Security

• Custom code security review completed
• File permissions secured
• Development modules disabled in production
• Error reporting configured appropriately
• User roles and permissions audited
• API keys and sensitive data secured

Performance

• Database queries optimized
• Cache configuration verified
• Image styles and media handling optimized
• JavaScript/CSS aggregation configured
• Views performance reviewed
• Development modules disabled

Content & User Experience

• Content types and fields reviewed
• Editorial workflows tested
• Required fields and validation rules verified
• User roles and permissions documented
• Menu structure finalized
• Sample content removed (if applicable)

Deployment & Maintenance

• Deployment script/procedure documented
• Backup procedures in place
• Update path tested
• Composer dependencies locked
• Node.js/npm dependencies locked
• Database update procedures documented

Final Review

• All custom modules tested
• All custom themes tested
• All features tested in production environment
• Client sign-off received
• Knowledge transfer sessions completed
• Access credentials provided to client
• Support contact information provided

Notes

• Add project-specific items here
• Document any known issues or limitations
• List any pending items for post-launch

Last updated: [Date]