Assembla Project Inspection
This inspection focuses mainly to provide suggestions for improvement.
Many Issues were already solved, see Breakout Project Related Tickets
General
- Missing Breakout Test Instance
Source Code
Assembla provides trac as an additional tool.
The source code of trac is not kept within an svn, thus the modifications must be tracked via patches.
Suggestion: Place Trac Source code within the svn, thus modifications are trackable.
Processes
Documentation:
- A Documentation Change Policy should be provided, thus project members and visitors feel secure about what to change and what not.
Project Entry:
- The entry process for new developers should be simplified further.
- New developers should document their project entry experience
Basic Setup:
- The basic setup should be made by a project newcomer on a remote host
- findings should be used to simplify the process
Resources and Terminology
It is difficult to get an overview within the Assembla.com/Breakout different spaces, trac instaces etc.
User's should be directed to one resource:
Breakout Docs, Bugs, and Suggestions should be renamed to "Breakout User Support" or similar
Developer's should be directed to one resource:
Breakout Software Development should be renamed to "Breakout Development Project" or similar.
The text should be reworked slightly, to just describe what this resource is about.
The Breakout Project main page duplicates the text for the user resources site.
Suggestion:
- This should be replaced by a simple link, to avoid repetitions.