-
Notifications
You must be signed in to change notification settings - Fork 174
Developer's Instrument Guide
Rida Abou-Haidar edited this page Apr 9, 2020
·
24 revisions
HOME > SETUP > DEVELOPER'S INSTRUMENT GUIDE
This guide reflects a typical workflow and best practices used by Loris developers at the MNI. Some specifics such as git workflow steps may not apply to all projects and implementations.
- An instrument should likely be coded manually in PHP if it involves:
- dependencies between fields
- special data formats or restricted types
- special scoring
- look-up Norm tables (t-scores etc)
- age-dependencies in administering the instrument
- Has it been coded before? Current instruments list
- Get the entire PDF or paper copy, including any “lookup” tables used for scoring/normalization.
- Find out: Which sections of the questionnaire should be included or omitted? Typically, administrative details included on the original form can be ignored, but instructions that will be helpful for the examiner might be included.
- Decide: How will all your fields map to the element types allowed by Loris form
- Find out: Does your instrument require certification? Are there certified examiners? Should users be certified as examiners for this instrument using the Examiner module?
- Create a new git branch based off the up-to-date branch for your project-specific repo.
- Create an instrument in the project/instruments/ directory.
- Insert the Instrument.
- Front-end testing.
- Push branch and create pull request to your project-specific repo. Assign relevant tags and tester.
- Update any management documents and/or add a category to your bug tracker utility.
NEXT: (2) Create an instrument
See also: