Contributing to Ampersand
Many people have contributed to the Ampersand project in the past, each in her or his own way. We're very proud of the results and we are amazed daily of the software that tiny specifications can produce.
If you want to be part of it, contact stefjoosten on Github to discuss your contribution.
This page serves as your central resource hub for everything you need as an Ampersand contributor.
🚀 Getting Started as a New Contributor
How do I join the team?
- Complete Onboarding Process - Essential first steps for new Ordina A-team members
- Schedule meetings with team leads
- Get access to GitHub repositories and Microsoft Teams
- Join sprint meetings and daily standups
- Clone necessary repositories
What coding standards should I follow?
- Contributor's Guide - Access the comprehensive contributor resources in the main menu
- Complete onboarding process for new team members
- Development tools and infrastructure documentation
- Team coordination and workflow information
📝 Documentation & Communication
How do I document my changes to the codebase?
- Documenting Prototype Framework Changes - Step-by-step guide for contributors
- Understanding the multi-repository documentation architecture
- Proper file structure and naming conventions
- Updating sidebar.js configuration
- Testing and deployment workflow
What's the project structure?
The Ampersand ecosystem consists of four main repositories:
- Ampersand - Core compiler and language implementation
- Prototype - Visual interface framework for Ampersand applications
- RAP - Repository for Ampersand Projects (used by Open University)
- AmpersandTarski.github.io - Documentation website builder
🔧 Development Workflow
Architecture Resources
- Architecture of an Ampersand Application - Understanding what Ampersand produces
- Technical specifications and system design documentation
Team Coordination
Regular Meetings:
- Weekly Overview: Monday 11:30 (1 hour) - NUTwente/Ampersand coordination
- Daily Standup: Tuesday-Friday 11:30 (30 minutes) - Progress updates
- Sprint Events (End of sprint, Fridays):
- Sprint Review: 9:00 (50 minutes)
- Sprint Retrospective: 10:00 (50 minutes)
- Sprint Planning: 11:00 (50 minutes)
Communication Channels:
- Microsoft Teams: Project A & NUT-Vluchtelingen open source
- WhatsApp Group: Ampersand team communication
- GitHub: AmpersandTarski Organization
GitHub Workflow
Required Access:
- Membership in AmpersandTarski organization
- Ordina A-team team membership
Documentation Workflow:
- Work in the documentation branch when creating/editing documentation
- Ensure documents are in the correct repository's docs folder
- Update relevant sidebar.js files when adding new documentation
💡 Contribution Areas
Core Development
- Ampersand language compiler improvements
- Prototype framework enhancements
- RAP application development
Documentation
- User guides and tutorials
- Technical reference materials
- API documentation
- Architecture diagrams
Quality Assurance
- Testing and validation
- Code reviews
- Performance optimization
- Bug fixes and maintenance
📚 Quick Reference
Key Contacts
- Stef Joosten: Project leadership and strategic direction
- Han Joosten: Access management and technical coordination
Important Guidelines
- Follow established coding standards and best practices
- Document all changes appropriately
- Test thoroughly before submitting contributions
- Participate actively in team meetings and reviews
- Maintain focus on user needs and system maintainability
🔗 External Resources
- GitHub Organization: AmpersandTarski
- Documentation Website: ampersandtarski.github.io
- Project Coordination: Microsoft Teams channels and meetings
Ready to contribute? Start with the onboarding process and explore the Contributor's guide section in the main menu for comprehensive resources. When you're ready to document your work, follow our documentation guide.
Welcome to the team! 🎉