Kuma

Kuma is the platform that powers MDN (developer.mozilla.org)

Development

Code:

https://github.com/mdn/kuma

Issues:

P1 Bugs (to be fixed ASAP)

P2 Bugs (to be fixed in 180 days)

Dev Docs:

https://kuma.readthedocs.io/en/latest/installation.html

Forum:

https://discourse.mozilla.org/c/mdn

Matrix:

#mdn room

Servers:

What’s Deployed on MDN?

https://developer.allizom.org/ (stage)

https://developer.mozilla.org/ (prod)

Getting started

Want to help make MDN great? Our contribution guide lists some good first projects and offers direction on submitting code.

Contents:

• Installation
  • Docker setup
  • Visit the homepage
  • Create an admin user
  • Interact with the Docker containers
• Development
  • Basic Docker usage
  • Running Kuma
  • Running the tests
  • Database migrations
  • Coding conventions
  • Managing dependencies
  • Customizing with environment variables
  • Customizing number of workers
  • Customizing the Docker environment
  • Customizing the database
  • Using secure cookies
  • Maintenance mode
  • Enabling PYTHONWARNINGS
• Troubleshooting
  • Kuma “Reset”
  • Reset a corrupt database
  • Run alternate services
  • Linux file permissions
• The Kuma test suite
  • Running the test suite
  • Markers
  • Adding tests
  • Changing tests
  • Removing tests
• Client-side testing
  • Setting up test environment
  • Running the tests
  • Using Alternate Environments
  • MDN CI Infrastructure
  • Markers
  • Guidelines for writing tests
• Celery and async tasks
  • When is Celery appropriate
  • Celery services
  • Configuring and running Celery
• Search
  • Indexing documents
• Documentation
  • Generating documentation
• Docker
  • Docker Images
• Deploying MDN
  • Pre-Deployment
  • Deploy to Staging
  • Deploy to Production
  • Deploy to Standby Environment