This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Last revision Both sides next revision | ||
about_the_class:the_basics [2015/07/28 07:01] ceisenhart |
about_the_class:the_basics [2015/07/28 17:03] ceisenhart |
||
---|---|---|---|
Line 2: | Line 2: | ||
Hello! I am the current wiki manager Chris Eisenhart, I was a student in the BME235 spring 2015 class. | Hello! I am the current wiki manager Chris Eisenhart, I was a student in the BME235 spring 2015 class. | ||
- | During our class the wiki grew so large that we lost track of it. This caused us to repeat a number of analyses, which wasted much of our precious compute power. I am currently the wiki manager, and am working hard to ensure this doesn't happen again! | + | This page acts as a ground level tutorial for changing the wiki. The other elements of the class (servers and whatnot) are described on the [[about_the_slug::about_the_slug | 'About the slug' ]] page. |
+ | |||
+ | During our class the wiki grew so large that we lost track of it. This caused us to repeat a number of analyses, which wasted much of our precious compute power. As the current wiki manager I am working hard to ensure this doesn't happen again! | ||
====Modifying the wiki==== | ====Modifying the wiki==== | ||
Line 19: | Line 21: | ||
6. Verify you did not mess up the table, then press 'Save'. | 6. Verify you did not mess up the table, then press 'Save'. | ||
- | ==Troubleshooting== | + | 7. **Finish reading this page and the [[about_the_slug::about_the_slug | 'About the slug' ]] page** |
- | You likely encountered this blurb on the front page, "This wiki is publicly readable, but editable only by people with UCSC School of Engineering computer accounts. Contact Kevin Karplus if you need to edit these pages and do not have such an account.", if you cannot 'login' to the wiki and are enrolled, please contact [[https://www.soe.ucsc.edu/people/karplus | Kevin Karplus]] to get access. | + | |
- | ==Namespaces== | + | ===Namespaces=== |
While you are dong this note the different 'namespaces' being used, the contributors page is stored in the 'about_the_class' namespace. Namespaces allow the site to be hierarchical (see the Sitemap button on the top right of the page) which enables easy access for non-UCSC institutes. Namespaces are equivalent to UNIX directories, so much so that we structure our publicly accessible data after the wiki namespaces! | While you are dong this note the different 'namespaces' being used, the contributors page is stored in the 'about_the_class' namespace. Namespaces allow the site to be hierarchical (see the Sitemap button on the top right of the page) which enables easy access for non-UCSC institutes. Namespaces are equivalent to UNIX directories, so much so that we structure our publicly accessible data after the wiki namespaces! | ||
- | ==Style guide== | + | ===Style guide=== |
After adding yourself to the contributors page, please take a look at the [[about_the_class::style_guide | wiki style guide]]. The style guide explains general rules for modifying the wiki. Please be mindful of these rules, the wiki managers take extra care (and time!) to ensure that there as few as possible so please follow them! | After adding yourself to the contributors page, please take a look at the [[about_the_class::style_guide | wiki style guide]]. The style guide explains general rules for modifying the wiki. Please be mindful of these rules, the wiki managers take extra care (and time!) to ensure that there as few as possible so please follow them! | ||
+ | |||
+ | |||
+ | ==Troubleshooting== | ||
+ | You likely encountered this blurb on the front page, "This wiki is publicly readable, but editable only by people with UCSC School of Engineering computer accounts. Contact Kevin Karplus if you need to edit these pages and do not have such an account.", if you cannot 'login' to the wiki and are enrolled, please contact [[https://www.soe.ucsc.edu/people/karplus | Kevin Karplus]] to get access. | ||
+ | |||
====Site managers==== | ====Site managers==== | ||
Line 33: | Line 39: | ||
**Duties;** | **Duties;** | ||
- | Site managers **start immediately**. | + | Site managers **start immediately**, the ensures that no changes are made to the wiki that are not reviewed by a site manager. |
- | Site managers should **not** change content (while performing site manager roles). | + | Site managers should **not** change page content (while performing site manager roles). |
+ | |||
+ | Site managers are responsible for managing and removing discussions. Discussions are publicly viewable, which means we need to limit them as much as possible. The site manager takes the discussion comments into account, makes the necessary changes to the page, then deletes the discussion comment(s) and informs the user of the changes. | ||
Site managers are responsible for the hierarchy and namespaces of the wiki. As the wiki grows new namespaces will need to be added. | Site managers are responsible for the hierarchy and namespaces of the wiki. As the wiki grows new namespaces will need to be added. | ||
- | The site managers must oversee the rest of the wiki modifications. This essentially means that the site managers are responsible for hounding the rest of the class to put their pages in the correct namespace. | + | The site managers must oversee the new wiki additions and current wiki modifications. This ensures that the new information is put in the correct namespace, and follows our current style guide. There is a very large [[archive::archive]] for deprecated pages, pages with bad namespaces, and pages that did not follow the style guide. As of 2015 the archiving effort is well underway, but not near completion. New managers will be asked to continue this effort. |