AFS Wiki FAQ
From AFSWiki
|
This page details frequently asked questions (FAQ) and their corresponding frequently-given responses. If your question is not already listed here please ask for further help by writing to sysadmin@afswiki.org.
|
General Questions
The AFS Wiki Itself: introduction and training
What is the AFS Wiki?
The AFS Wiki is a collaborative, online manual accessible and editable by all AFS volunteers. A description or slogan for the ideal AFS Wiki might be, "Everything AFS-USA Volunteers Need To Do Their Job."
We have created an online tutorial to help guide new users through the basics of finding information, knowledge and documents on AFS Wiki. It is entitled Accessing Information on AFS Wiki and will have you feeling confident as a user in very little time.
Will volunteers and staff need training in order to navigate the Wiki?
Users who will be making substantial changes may need some minimal training, but the idea of the wiki is that it is easy to use and for most people doing simple edits, no training is needed. The wiki itself provides help. However, the Training group and Volunteer Services have created some initial training documents that volunteers will be able to download, and print. See: Accessing Information on AFS Wiki.
Access
Why do we require a username and password for access?
How do I get a username and password?
See AFSWiki Request New User Process.
Once I have a username and password, how do I log in?
Navigate to the login screen at www.afswiki.org.
Once you first log in, please navigate to the Preferences link in the top right corner. There, you should change your password to something personal. Please create your own password that is easy to remember, but secure and known only to you. You must change your password soon, because for security reasons, we will suspend accounts that have not changed the temporary password.
Benefits of Wiki Technology
What makes a Wiki different than a normal website?
Typical web pages can only can be changed by their author. AFS Wiki pages can be changed by any volunteer with a username and password.
There are a few exceptions to this "Any Volunteer Can Edit" policy: sensitive documents, such as application forms or lists of government regulations, can only be changed by a group of specially trained users.
Why are we changing the technology? I'm used to using AFS Online.
We have about reached the limits of what AFS Online can do for us. By moving AFS Online's static information to the AFS Wiki and the personal and statistical information about participants to AFS International's Global Link system, we'll get the best combination of technologies available.
- The AFS Wiki is editable by all our volunteers, so it's easy to keep up-to-date.
- It allows us to search for any word or phrase within the system.
- Volunteers and staff alike can organize the information however we like. For example, the same information can be organized in multiple ways through creation of links.
These functionalities were not available from AFS Online.
Although you will probably have to learn some new skills to use the AFS Wiki, Wikis in general are an increasingly common technology. Their use is a skill that some volunteers will already have, while others will be able to reuse the skills they learn here in other projects. The online encyclopedia at wikipedia.org is the 9th most visited site on the web and runs on exactly the same software as AFS Wiki.
Why should I be editing this volunteer manual?
AFS is a volunteer-based organization, and we believe that much of the best advice for volunteers comes from other volunteers. As a conference invitee, you're a leader and have information that's worth making available to fellow volunteers.
How Wikis work
How do Wikis avoid total chaos?
Wiki is based on the principle of read first, then correct and contribute. Authors are conservative in their approach, looking to improve, rather than change or control information. Like many things, the honor system and a few established rules of thumb can achieve a lot when volunteers come together.
Even in totally anonymous wikis, people don't typically make changes unless they can improve on the original. Note that "improvement" is the goal, not "perfection:" we want you to make changes even if you know that the resulting document won't be perfect.
Additionally, we're somewhat protected because only AFS volunteers can view content and make changes. Also the history of a page is retained indefinitely, allowing us to recover past versions if necessary, and allowing any curious person to see who has made what changes.
How do I embody the Spirit of the AFS Wiki?
Next time you have a question about being a volunteer, try to answer it by consulting the AFS Wiki. If the answer is missing, first find the answer through other means. Then update AFS Wiki to serve the next person with your same question .
Next time someone else asks you a question, do NOT answer it directly. Instead, you will make sure the AFS Wiki provides the answer, updating it if necessary. Then you will refer your questioner to the appropriate page of the Wiki.
Once you have embodied these principles, you will have achieved the True Wiki Spirit.
Content
Content from AFS Online seems missing. How can I find it?
The Search tool on the wiki is actually more effective than the previous AFS Online Library. We are also working to make the Wiki even better organized, with better links, and more complete content.
For questions about where to find information which had previously been accessible via the library, see: AFS Online Library support contacts
Editing
How do I edit a page?
A great way to get started and help improve the AFS Wiki is to edit an existing page, adding or updating content that you know to be missing or inaccurate. For example, try searching for your area team. Its contact information is probably missing or incomplete; you can fix that!
For a comprehensive overview of editing and adding content, go through the online tutorial Making Changes to AFS Wiki. You can also go straight to a page and try editing it. To do this, click on the "edit" tab at the top of the page, make your changes, click "show preview" to make sure the changes look right, then click "save page" to finish.
If making your first edit on a real page feels too dangerous (even though it's not -- we can always recover previous versions of the page), there is a special sandbox. In addition, we are developing an AFS Wiki Style Guide that should, as it develops, should help answer your questions about how to deal with certain types of content, such as linking to other pages, adding images, etc..
How do I make fancy changes like adding links, adding new pages, changing formatting, etc?
The best way to learn is by copying what you like on other pages: click "edit" on any page and you'll see how the effect was achieved. Unless you type "save page," clicking "edit" won't affect the original.
There are also general reference guides for editing a wiki. One of them covers General Formatting and another focuses specifically on Creating Links. Links to these pages and more are on the AFS Wiki Reference page.
How do I create an article with pictures?
On the left hand side, under search, in the box labeled toolbox, click on "Upload file." Upload the file to wiki. Inside the article, reference the image in the form
[[ Image:filename.jpg | 100px | thumb | Caption text here ]]
See also the article: AFSWiki add photo to existing page
How can I edit a locked document or suggest improvements to a document that I can not change?
A locked document can not be edited, however in the discussion section of a page suggested edits can be listed.
How do I create a booklet of selected articles?
See: HOWTO create an AFS Wiki booklet
Where can I get ideas on what to work on?
See the AFS Wiki Current Issue List.
HELP
Who do I contact if I have a problem logging on or need help with the Wiki?
Send an mail to sysadmin@afswiki.org
