RFC Document
Request for Comments template for proposing technical changes. Includes problem statement, proposed solution, and alternatives considered.
Available Variables
Use these variables with Handlebars syntax {{variableName}} in your content.
{{con1}}Increased operational complexity
{{con2}}Eventual consistency challenges
{{con3}}Steeper learning curve for team
{{date}}January 2025
{{pro1}}Better scalability and performance
{{pro2}}Improved fault tolerance
{{pro3}}Easier to add new consumers
{{title}}Implement Event-Driven Architecture
{{author}}Alex Kim
{{phase1}}Infrastructure setup and team training
{{phase2}}Migrate notification service
{{phase3}}Full production rollout
{{status}}Under Review
{{summary}}This RFC proposes migrating our monolithic request-response architecture to an event-driven architecture using Apache Kafka as the message broker.
{{rfcNumber}}0042
{{motivation}}Our current architecture is struggling to handle the increasing load and complexity of our system.
{{phase1Date}}Q1 2025
{{phase2Date}}Q2 2025
{{phase3Date}}Q3 2025
{{codeExample}}// Event producer example await kafka.produce('user.created', { userId: user.id, email: user.email, timestamp: Date.now() });
{{decisionStatus}}Pending approval from Architecture Review Board
{{alternative1Desc}}Traditional message queue with AMQP
{{alternative1Name}}RabbitMQ
{{alternative2Desc}}Managed queue service
{{alternative2Name}}AWS SQS
{{motivationPoint1}}Reduce coupling between services for better maintainability
{{motivationPoint2}}Enable horizontal scaling of individual components
{{motivationPoint3}}Improve system resilience through async processing
{{proposedSolution}}We propose implementing an event-driven architecture using Apache Kafka with the following key components:
{{stakeholder1Name}}Mike Johnson
{{stakeholder1Role}}Platform Lead
{{stakeholder2Name}}Lisa Wang
{{stakeholder2Role}}Staff Engineer
{{alternative1Reason}}Limited scalability for our volume
{{alternative2Reason}}Vendor lock-in concerns
{{stakeholder1Initial}}M
{{stakeholder2Initial}}L
More developer Templates
Release Changelog
Developer-friendly changelog template with version timeline, categorized changes (Added, Changed, Fixed), and contributor badges.
API Documentation
Professional API documentation template with sidebar navigation, endpoint cards, and code examples. Developer-friendly design.
GitHub README
Beautiful GitHub-style README template with badges, feature grid, installation guide, and code examples. Perfect for open source projects.