Review Criteria (Evaluation Manual for Developers)
When a device/extension is submitted for review, mBlock team member refer to following criteria while reviewing.
It is highly recommended that each developer consult the these criteria while developing or debugging, for both the efficiency of development and project quality.
Modules for review
| Module | Reviewing items |
|---|---|
| Blocks | Displayed variables/hidden variables; all blocks in the list; disabled ones in "Upload" mode |
| "Live" mode functions normally | |
| "Upload" mode functions normally | |
| Checkbox functions normally (display value on the stage) | |
| Firware | Upgrade functions normally |
| Firmware name does not include firmware version number | |
| Translation | Device/extension - all blocks are tranlated |
| Device/extension - category names are translated | |
| Device - device name is translated | |
| Extension - description is translated | |
| Device/extension - parameters are translated | |
| Device - firmware name is translated (if any) | |
| Device - pop-up settings windows is translated (if any) | |
| Device - prompt message for serial port connection is translated (if any) | |
| Device - prompt message for bluetooth 4.0 connection is translated (if any) | |
| Device - prompt message for failed firmware upgrade is translated (if any) | |
| Connection | Serial port connection functions normally (if any) |
| Bluetooth 4.0 connection functions normally (pc built-in bluetooth) | |
| Compatibility | Blocks of new version are compatible with blocks of old versions |
| Blocks work on all support platform (pc, web, mobile) | |
| Others | Valid links for help documents |
| Texts have no obvious errors (blocks, prompt messages, etc.) |
Debugging Suggestions
- Check the combination of value blocks and repeat blocks
- Check the parameters of value blocks
- Check the combination of blocks with default blocks
- Check value blocks with checkbox (display on the stage)
Prompt message
Suggestions and requirements:
The link of connection help document should be valid
- Successful connection has the default prompt
- Failed connection prompt: less than 5 pieces, each fewer than 30 characters, all together less than 80 characters
The link of upload help document should be valid
- Successful upload has the default prompt
- Failed upload prompt: less than 5 pieces, each fewer than 30 characters, all together less than 80 characters
The link of firmware upgrade help document should be valid
- Firmware upgrade prompt: less than 5 pieces, each fewer than 30 characters, all together less than 80 characters
- Firmware upgrade in process: less than 5 pieces, each fewer than 30 characters, all together less than 80 characters
- Successful upgrade: less than 5 pieces, each fewer than 30 characters, all together less than 80 characters
- Failed upgrade: less than 5 pieces, each fewer than 30 characters, all together less than 80 characters
Note: check the translation all prompt message.