Experimental project
This is a sandbox project, which contains experimental code for developer use only.
A sandbox for working on the entity API for Drupal 8 core.
See related meta issues:
#1346204: [meta] Drupal 8 Entity API improvements
#1346214: [meta] Unified Entity Field API
Get in touch with fago if you need access!
Development guidelines
- Branches
entity/entity-[topic]-base
: Upstream tracking8.x
branch of Drupal core for a particular topic/feature branch.Each topic branch MUST use a separate and corresponding -base branch, so each topic branch can be diffed against its relative 8.x base.
To create or update a base branch:
git push entity 8.x:entity-topic-base
entity/entity-[topic]-[issue]-[username]
: Topic/feature branches under development per user.Based on the respective topic base branch, or the branch of another user.
origin/*
: Your regular upstream Drupal core branches.
- Always commit atomic changes
Do not change X different things in a single commit. Commit early, commit often.
Commit atomic change-sets. Touching 10 files for a particular change is OK. Touching 10 files for 2-10 different changes is absurd. Exception: Coding style, documentation, and comment clean-ups/fixes.
- Provide proper credit
When applying a patch from someone else, attribute the author by using the --author option:
git commit --author="sun <sun@54136.no-reply.drupal.org>"
The Git attribution option is exposed on each user's profile page (example).
- Write proper commit messages
Entity branches may be merged into Drupal core. Each commit message should make sense when being looked at in a partial context; e.g., when only looking at the file history of foo.module. Don't do this. Follow the general commit message guidelines as much as possible.
Developer setup
Please have a look at the guidelines over at sun's platform sandbox: http://drupal.org/sandbox/sun/1255586
Project information
- Created by fago on , updated