To define a new Project, you must login to your account, go to the Preferences page, and invoke the "Register Project" command. After doing so, a page appears as illustrated in Figure 3.8, “ An empty Project Registration Page ”.
The first field on this page requests a Project Name, which needs to be unique with respect to your other defined Projects, and which for convenience purposes should not contain any space characters. (This is because certain alerts contains project names as parameters, and space characters make these URLs more difficult to manage.)
The second field requests a Start Day. All Projects have a start day. Only data occurring on or after the start day is considered in Project-related analyses.
The third field requests an End Day. You can provide a specific end day, or simply check the "Undetermined" radio button. In this case, the Project extends from the Start Day to the current day.
The fourth field requests a list of member emails. Your email, as the person defining the Project (and thus the Project "owner"), is always listed. The system will generate an error if you delete your email address and try to create the Project without it. You can add other email addresses into this text area. Note that all of the email addresses you enter are checked to ensure that they correspond to actual Hackystat users on this server. There is no way for you to "look up" the email address of another Hackystat user on this server. Indeed, there is no way for you to even find out who are the other Hackystat users on this server. Thus, to form a Project, you must simply talk to your Project co-workers, verify that they have an account on this Hackystat server, and find out what email address you must use to list them as a member of the Project.
The fifth field requests that you specify one or more Workspaces that together encompass the set of the file system locations containing the artifacts under development in this Project. As noted, you can use the shift and/or control keys to select more than one Workspace. Only the "Displayed" workspaces are presented in this list. If you find, for example, that you want to define a Project and restrict the artifacts of interest to an internal subdirectory, then you will need to use the "Display or Hide Workspaces" command on the Preferences page to "unhide" the workspace of interest. See Section 3.4, “Defining Workspace Roots” for more details about this command. It is also important that all members of the Project set up their Workspace Roots so that every member has the Workspaces associated with this Project. If you find that a member's data is not appearing in Project-level analyses, an incorrectly set Workspace Root is usually the problem.
The final field is simply a textual description of the Project. You can supply a brief description, or leave it blank.
Note that once defined, all of the Project-related values can be changed with the sole exception of the Project Name. If you want to change a Project Name, then you have to delete the Project, then create a new one with the new name. Editing and deleting Projects are accomplished using the Manage Projects command, discussed in Section 3.7, “Editing and Deleting Projects”.
Figure 3.9, “ A filled out Project Registration Page ” illustrates a Project Registration page which has been filled out to define a Project called "04-11".
This project tracks the work performed on a publication for IEEE Software on Software Project Telemetry. All of the documents related to this work are contained in the workspace 04-11, and there is only one developer involved in this Project.