You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Next »

Wiki Training Lecture

Make sure you have created the new semester's team roster before giving this lecture! Also make sure you have added all new members to the wiki as directed at the bottom of the list of early responsibilities

This lecture is meant to provide an outline of basic skills team members need to successfully edit the wiki. Without these skills they will be unable to do any of the assignments or correctly document their research, so this lecture is very important. Make sure to host this lecture in a computer lab so every student can sit on the wiki and follow along while you project your screen in the front of the room and lead them. Carpenter Library has the Accel labs, which are OK for this. They usually make you take upstairs rooms, though, which are too small for the whole team so you will need to book two and make sure to recruit someone to lead the lecture for the other half of the class.

General Information and Introduction

The wiki is not meant to be an online repository for reports. It is a dynamic database that we continually update. It is meant to provide resources on every facet of AguaClara, from research to design to outreach to syntax and grammar! Whenever you are updating the wiki, think very carefully about where you are placing information and how you are presenting it.

Always Remember!
  1. The wiki is our face of open source engineering. That means that everyone from scientists and engineers to potential donors to your parents goes on it to see what we are up to. Every word you write must be spellchecked and professional.
  2. Please do not just put stuff up here to make it look like you've been doing extra work. It doesn't fool anyone and it just means that your midterm or final feedback will tell you to rewrite everything! This is a real database and we cannot have it bogged down with fluff.
  3. The answers to most of your questions and uncertainties are probably already there. We have an in-depth wiki organization guide, photos, and there are always other pages to steal formatting code from.
  4. The wiki is set up like a tree, there are important branches fanning outward from the Home page and where you put new pages in the hierarchy is very important.

A Tour of the Wiki

Start the tour at the Home page, it can be accessed by typing http://AguaClara.cee.cornell.edu. Have everyone follow along with you so they get an idea of how to navigate through it.

  • From the home page you can easily access the major branches of the project: Research, Design, and Outreach. Another important branch from the home page is Team Resources
    • What is a child page?
  • How do you find
    • Past research
    • Information about other teams
    • Assignments
    • Outreach events
    • Contact info for other people on the team
    • International experience information
    • the sandbox
      • This one is trickier because you cannot navigate directly to it, you have to use the search field.

Editing the Wiki

Show everyone how to log in

Your First Wiki Assignment

At the end of the lecture take 5 minutes to explain the personal page assignment. Have everyone go back to the Home page and show them again how to navigate to the syllabus and to the assignments page (both from team resources). Show them the personal page assignment, it has very detailed step-by-step instructions, and tell them they should do it ASAP while the wiki lecture is still fresh in their heads!

  • No labels