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

Compare with Current View Page History

« Previous Version 3 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
      • lead the team to the Research page and show them the different team represented. Show them a typical research team page. home>research>?
    • Information about other teams
      • Just explain to them again how easy it is to navigate from the home page to all of the team pages
    • Assignments
      • Make sure to show them a few different assignments--highlight how there is information on expected content, formatting, and grading there, but due dates are all on the syllabus
    • Outreach events
      • The outreach team is responsible for maintaining a calendar of all the events that are coming up that they need team members to speak at or help with. These can be found by navigating to Home>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. The sandbox is not navigable because it is just a place to play--if you are not sure about how to do something, try the code in the sandbox first so you can test if it works without messing up your own wiki page.

How Do We Use the Wiki?

  • It is not a historical account, it is a dynamic database
    • Keep information current, updating is better than adding
  • Meeting Minutes are done every week on the wiki to chart your progress
  • Communication between teams, the engineers in Honduras, outreach, etc

Editing the Wiki

Show everyone how to log in
The most important part of editing the wiki is using the wiki organization guide. Show the team how to navigate from home>team resources>wiki organization guide. Browse the structure of the guide with them--there are directions there for formatting,

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