Project Documentation on TRAC Wikis

Over the weekend I had a first look at the project documentation on the team wikis. While I received a few requests for an extension of the deadline of last Thursday, I was quite disappointed to see that most teams do not have anything on their TRAC Wikis yet.
I will grade the Milestone Week 2 documents on Friday, so you need to make sure that your TRAC wiki contains at least the following by Thursday, midnight:
- Title of you project, optionally a team name
- list of the team members
- short description of the project
- comparison against existing related systems
- features, requirements, and evaluation criteria
- schedule

For reference purposes, you can look at last year’s team with the highest score for their documentation,
Project Deuce.

My general policy is to let teams revise each document once, but the maximum improvement of their score will be half of the difference between the overall maximum score and their score in the first version. So if a team gets a score of 4 out of 10, the best they can hope for after revisions is (10-4)/2 = 3, resulting in an final score of 4+3 - 7.

Blackboard AI Wiki, Discussion Board Access Problems

If you’re getting an “Access Denied” message when trying to go to the AI Wiki or Discussion Board on Blackboard, let me know. The wiki is on a separate Blackboard course, and especially for students who added the course later, I may have to manually add them.

TRAC Wiki SVN Access

To access the SVN repository of the TRAC Wiki, add /svn either before or after the name of your wiki in the URL. So for team 11, this would be
https://wiki.csc.calpoly.edu/svn/CSC-480-F11-11/ or
https://wiki.csc.calpoly.edu/CSC-480-F11-11/svn/

See more information at
https://wiki.csc.calpoly.edu/labs/wiki/WikiGettingStarted, the “Repository Browser” entry of the “Help/Guide” tab on your Wiki(https://wiki.csc.calpoly.edu/CSC-480-F11-11/wiki/TracBrowser), or http://trac.edgewall.org/wiki/TracSubversion for the technical details.

Project TRAC Wikis Available

Our sysadmins created a number of TRAC wikis for us, to be used for the team projects. I want you to use them mostly for the project documentation, but you can also use their SVN functionality as a code repository. On Tuesday, we’ll assign the team numbers, and I’ll add one team member to the wiki. This person then can add the rest of the team. If you can’t wait until Tuesday, send me an email, and I’ll do it earlier. Please include your section (morning or afternoon) and the project title in that email.

My strong preference is for all teams to use the TRAC Wiki, at least for the documentation. This is mainly for two reasons: Persistence (documents on your personal Cal Poly Web page, for example, will disappear when you graduate), and consistency, which makes it easier for me to find a particular piece of documentation. If you have a good argument for using something else, I’m open to it, but please discuss it with me first.

For each team wiki, I've created a group "Members" with SVN_READ, SVN_WRITE and TRAC_ADMIN privileges.
To add your team members to the wiki, do the following:
  • go to the Wiki
  • login with your CSC login information (login name, password)
  • go the the "Admin" page by clicking on the "Admin" tab , and then "Permissions" in the list on the left.
  • enter their login names one by one in the "Add Subject to Group" area to add them to the "Members" group

If you want to exercise tighter controls, you can also create different groups with restricted privileges, and assign them to those groups.

AI Nuggets Presentations

If you have a topic for your AI Nugget presentation, you can sign up for it on Blackboard. Go to the “AI Wiki”, and follow the link to the presentation schedule for your section. Instructions are on the Wiki. I will publish the Web pages with more information on the AI Nuggets task soon. If you’re looking for topic ideas, try my collection of Web snippets in the AI Nuggets Evernote Notebook. You may also find some ideas in a related notebook, KM Nuggets, with an emphasis on knowledge management.

Project Template Available on your Team Wiki

When you create new pages in your wiki, you can select templates from a pull-down menu. Those templates are intended for my courses with team projects, and they contain information on what to put in the respective pages.