README.md

OS2Forms

Table of contents

• Description
• License
• Testing and CI
• Git guideline
• Code review
• Code of Conduct
• Links

Description

OS2Forms is a drupal based solution for creating advanced webform functionality for Danish Municipalities.

License

All OS2Forms projects are using EUPL v1.2 License.

Testing and CI

This project has continuous integration builds that are performing by Travis CI. To improve code quality and integration possibilities there are using set of following tools:

• PHP_CodeSniffer with Drupal coding standards and best practices defined in Coder module.
• ESLint with Drupal ESLint rules set.
• Stylelint with rules set defined for Drupal core.
• Twigcs with standard set of rules for twig templates.
• Drupl-check to check project readiness to Drupal 9 via checking of deprecated code usage.
• @TODO PHPUnit test to check key contrib modules tests.

For more details about travis-ci continuous integration builds see .travis-ci.yml file.

NOTE: Project doesn't have its own PHPUnit test. This is a part of future development scope.

Git guideline

Since OS2Forms is Drupal module project, there is used drupal-friendly git branch/tag names.

Bracnhes

• 8.x - genral development branch.
• 8.x-2.x - development branch for version 2.x.

There is no specific rules for feature branch names. However we recommend use OS2Forms JIRA or github issue ticket number as prefix for your branch name.

Tags

Release tags should be created from related branches. Examples for tags created from 8.x-2.x:

• 8.x-2.0-alpha, 8.x-2.0-alpha1, 8.x-2.0-beta - test release tags.
• 8.x-2.0-rc1, 8.x-2.0-rc2 - release candidate tags.
• 8.x-2.0, 8.x-2.1 - stable release tags.

Code review

New changes or bugfixes in existing codebase have to be added to repository through general code review process. To request a code review, use the following process:

1. Add Github pull request from the feature/bugfix branch to 8.x or other related dev branch.
2. Request code review from one of project contributor.
3. Reviewer approves, requests changes or rejects pull request.
4. Discuss/Add requested changes or merge approved pull request.

NOTE: There are preconditions that have to be met before accepting a pull request:

• All requested changes have to be done
• All discussion have to be resolved
• Pull request should have green Travis CI build status.

Code of Conduct

See Drupal community code of Conduct

Links

• Drupal code standards