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

Compare with Current View Page History

« Previous Version 9 Next »

Wiki Training Lecture

Google Account

  • Log in. You must be on the AguaClara team to have access to the username and password.
  • There is a folder for every team where you can store all of your documents.
  • You can share these documents with your personal account so that it is easier for you to edit them.
    • To do this: Click share... in the upper right hand corner. Click on Invite People. Add your email address. Make sure the To Edit bullet point is selected. Hit send.
  • I embedded the challenges and calendars, and your team leaders will embed the weekly minutes into the wiki so that people can see them/access them from there and they are open to the public for viewing.
  • Weekly minutes are not turned in, but expected as a way to organize your team. Record problems, progress, and important details.
  • Calendars. Each team has their own calendar. This should be used as a way to keep track of meeting times and deadlines for assignments. To view a certain calendar just click on it so it is highlighted under My Calendars. You can then click on a specific date to add an event.
    • You can share the calendars with yourself by clicking on the down arrow next to the calendar name under My Calendars, clicking Share This Calendar, adding your email address, selecting Make changes AND manage sharing under the Permission Settings tab and clicking Add Person.
    • It is a good idea to share the cuaguaclara calendar with yourself because it has deadlines and general AguaClara events.
    • Matt and Monroe's calendars are under Other Calendars if you would like to make an appointment with them.

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. The wiki is used for communication between teams, the engineers in Honduras, and future members of the project.
  3. 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. The wiki is a dynamic database. You should update the wiki, not just add to it, so if something is out of date you may delete it or fix it.
  4. 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.
  5. 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.

  • 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? Each successive branch of the tree is a child page of the branch above it. Design Calendar is a child page of Design, for instance.
  • How do you find
    • Past research
    • Assignments Home>Team Resources>Team Assignments
    • 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.

Editing the Wiki

The most important part of editing the wiki is using the Wiki Organization Guide home>team resources>wiki organization guide. Here you can find directions for formatting assignments, figures, pictures, equations, etc.

  • Log in
    • Go to View on the top left of any wiki page.
      **
  • Create a new page and immediately set the default to Wiki Markup and not Rich Text (rich text seems easy but there are a lot of bugs in it and it is harder to keep our formatting consistent with it, wiki markup is easy to learn and it allows us to all use the same headings, bullets, etc)
    • Add a template to it, distinguish between the "Global" (useless) templates and ours which are "Space" templates
    • Talk about naming conventions-- do not name a page "Meeting Minutes 3/3/03" you should always use a descriptor for your team like "Team A Meeting Minutes 3/3/03" so there is no confusion between who is responsible for what pages. Also the page name becomes part of its web address, so it is helpful to be descriptive.
  • Create different headings on it
  • Add a link using brackets
  • Add bullet points
  • Move that page
  • Now delete it

Now take them to the calendar and explain that each team has to log in to CUAguaClara@gmail.com and add their weekly meeting times and locations.

Also go to edit a page that has pictures and equations on it so you can show them what the code looks like to do that. Remind everyone that the directions for adding equations and figures are in the wiki organization guide and they don't need to remember the code!

  • For figures it is easiest to copy code from another image and modify it for your page

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!

Team Leader Preparation for 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. The wiki becomes overloaded very easily, however, so it might be best for several students to work together or even for students not to follow along if it slows your presentation down significantly.

  • No labels