Contributor Guide

You want to contribute to the Lino source code? That's great! Thanks in advance!

This part of the developer guide is for core developers and for contributing developers.

Before getting started

• Legal considerations for contributors
  • Contributor License Agreement
  • Coding standards
  • Standard files

Get started

• Setting up a Lino contributor environment
  • Run getlino to clone Lino repositories
• Setting up your work environment
  • What is a project?
  • Navigating between projects
  • Some more shell aliases
  • Configuring atelier
  • Usage examples
  • Have LibreOffice server running on your machine
  • Quickly installing the Lino SDK into a new virtualenv
  • How to switch to the development version of Atelier
  • Where to store repositories
• Moving from GitHub to GitLab
  • How to update the remote setting of your clone
  • How to move a repo from GitHub to GitLab

Sharing code with others

• How to submit a pull request
  • Send a patch
  • Using GitHub
  • Using git request-pull
  • Pushing directly to master branch?
• Working with others
  • Home Office Teams
  • Contributing code
  • Send a patch
  • Submit a pull request
  • Continuous integration
  • About demo projects
  • What means inv ?
• The deployment process
  • Running the Lino test suite
  • Date-based versioning
  • Simulating a release on PyPI
  • Publishing to the official PyPI
  • Deployment checklist

Testing

• Testing Lino applications
  • Django tests in demo projects
  • Doctests in Lino
  • Migration tests
  • Cypress
  • Travis CI
• The manual testing suite for the Lino framework
  • Multiple addresses

Internationalization

• Instructions for translators
• Lino in Bengali

Drafts

• Coding style
• Debugging generated ExtJS Javascript code
• Repairing data

Internals

• How Lino applications use setup.py

Other

• Testing pages
• Git cheat sheet
• Reference
• About logging in a development environment
• Running linod
• Responsive design
• Using Lino Noi
• Some bash aliases we use
• Diamond inheritance
• About analysis
• About django-admin commands
• Screenshot tours
• Social Authentication
• What is an application?
• Introduction to Combo boxes
• Chooser examples
• Demo fixtures
• Setting up a simulated production server
• Simulate a HTTPS server on your development machine

Thanks to