relative links

Author: jaysa68

docs/staff-docs/archive/i3wm.md

@@ -3,6 +3,6 @@ title: i3wm
 ---
 
 `i3wm` or `i3` is is a tiling window manager we use on `tornado`, which is the computer behind the ocf tv.
-To learn how to access the ocf tv, see [ocf-tv](/staff-docs/scripts/ocf-tv/). A tiling window manager is
+To learn how to access the ocf tv, see [ocf-tv](../scripts/ocf-tv.md). A tiling window manager is
 a window manager that breaks the screen into different tiles, and places applications into these tiles,
 which are normally controlled by keyboard shortcuts instead of by dragging and dropping.

docs/staff-docs/archive/munin.md

@@ -2,7 +2,7 @@
 title: Munin
 ---
 
-**NOTE:** We are currently in the process of migrating many of our monitoring services to Prometheus. For more information, visit the documentation page for Prometheus [here](/staff-docs/infrastructure/prometheus/).
+**NOTE:** We are currently in the process of migrating many of our monitoring services to Prometheus. For more information, visit the documentation page for Prometheus [here](../infrastructure/prometheus.md).
 
 We use [Munin](https://munin.ocf.berkeley.edu) to provide real-time monitoring
 of our hardware. The master is [dementors](https://www.ocf.berkeley.edu/docs/staff/backend/servers/) which

docs/staff-docs/archive/znc.md

@@ -12,7 +12,7 @@ to connect to the bouncer from your desktop client, irssi, phone, etc.
 It's handy to avoid constantly disconnecting/reconnecting from IRC. It will
 also store messages you've missed and replay them when you log in.
 
-It's useful along with [OCF's IRC server](/user-docs/contact/irc/).
+It's useful along with [OCF's IRC server](../../user-docs/contact/irc.md).
 
 ## Installing ZNC on your staff VM
 

docs/staff-docs/get-involved/index.md

@@ -34,7 +34,7 @@ We hold two meetings each week during the fall and spring semesters. If you're
 new to the OCF, we recommend you attend our [General
 Meetings](staff-meetings.md). If you're curious about the larger technical and
 administrative decisions we make, you can also listen in on our [Board of
-Directors](../bod) meetings.
+Directors](../bod/index.md) meetings.
 
 ### Linux SysAdmin DeCal
 
@@ -65,7 +65,7 @@ If you’re feeling particularly adventurous, you could also [search for the str
 
 #### Help Tickets
 
-During the semester, our [help@ocf.berkeley.edu mailing list](../../user-docs/contact)
+During the semester, our [help@ocf.berkeley.edu mailing list](../../user-docs/contact/index.md)
 gets around 14 emails per week from the UC Berkeley community. Volunteers like
 you respond to these emails. Most requests are about requesting virtual hosting
 and helping users debug or fix their websites. If you’re interested in seeing
@@ -105,7 +105,7 @@ attending staff hours can serve multiple purposes:
 **I wasn’t able to make the first/second/nth meeting of the semester, can I
 still join?**
 
-Yes! You can join at any meeting at any time. If you’re worried about what you’ve missed, you can ask a veteran staffer to bring you up to speed or review the [BoD minutes](../bod) for that week.
+Yes! You can join at any meeting at any time. If you’re worried about what you’ve missed, you can ask a veteran staffer to bring you up to speed or review the [BoD minutes](../bod/index.md) for that week.
 
 **What if I can’t physically be present at weekly meetings?**
 

docs/staff-docs/get-involved/starter-tasks/index.md

@@ -25,8 +25,8 @@ them over the command line. There are a lot of online resources about using the
 Linux command line, so if you're confused about something, try Googling it!
 
 If you haven't used the command line before, you can go to our [command
-reference](/user-docs/services/shell/commands/) page and try running some commands. You
-can also connect to [our ssh server](/user-docs/services/shell/)
+reference](../../../user-docs/services/shell/commands.md) page and try running some commands. You
+can also connect to [our ssh server](../../../user-docs/services/shell/index.md)
 (`ssh.ocf.berkeley.edu`) using your own SSH client.
 
 If you want to get more comfortable, try completing [lab
@@ -61,18 +61,18 @@ group. Staff members use the
 [`signat`](https://ocf.io/docs/staff/scripts/signat) command to perform this
 check.
 
-1. [Log into supernova](/staff-docs/procedures/ssh-supernova/).
+1. [Log into supernova](../../procedures/ssh-supernova.md).
 2. Use the `signat` command to list the signatories for the Open Computing
    Facility or another student organization of your choice. Hint: if you are not
    sure how to use the `signat` command, try running `signat --help`. This trick
    works with most commands. OCF scripts also have [documentation on this
-   website](/staff-docs/scripts/signat/).
+   website](../../scripts/signat.md).
 3. Find the source code for this script on GitHub. Hint: if you’re not sure
    which repository something is in, you can use [OCF Sourcegraph][sourcegraph]
    to search across all repositories!
 
 ## Play with your webspace
-Every OCF account has [web hosting](/user-docs/services/web/) enabled at
+Every OCF account has [web hosting](../../../user-docs/services/web/index.md) enabled at
 https://www.ocf.berkeley.edu/~yourusername. As an example, check out [ckuehl's
 website](https://www.ocf.berkeley.edu/~ckuehl/).
 
@@ -84,7 +84,7 @@ website](https://www.ocf.berkeley.edu/~ckuehl/).
 [ocflib][ocflib] is a Python library we maintain which is installed on every OCF
 host. For this exercise, you won’t need to make modifications to ocflib.
 
-1. [Log into supernova](/staff-docs/procedures/ssh-supernova/) and start an
+1. [Log into supernova](../../procedures/ssh-supernova.md) and start an
    IPython3 shell (the `ipython3` command).
 2. To make sure things are working:
    1. Run `import ocflib.lab.staff_hours` to import utilities relating to
@@ -114,13 +114,13 @@ request][github-pull-request] on GitHub. Pull requests allow staffers to propose
 changes in discrete chunks and get feedback before the code goes live.
 
 You're going to make a pull request to [ocfweb][ocfweb]. Specifically, you'll
-add your name to [the list of everyone who's completed this task](/staff-docs/get-involved/starter-tasks/completed/).
+add your name to [the list of everyone who's completed this task](completed.md).
 
 ### Set up
-1. Log into [GitHub](https://github.com). If your [OCF email](/user-docs/services/mail/) (`<OCF username>@ocf.berkeley.edu`) is not connected to your
+1. Log into [GitHub](https://github.com). If your [OCF email](../../../user-docs/services/mail.md) (`<OCF username>@ocf.berkeley.edu`) is not connected to your
    account, [add it to your account emails](https://github.com/settings/emails).
 2. Create your personal [fork][github-fork] of [ocfweb][ocfweb].
-3. [Log into supernova](/staff-docs/procedures/ssh-supernova/).
+3. [Log into supernova](../../procedures/ssh-supernova.md).
 4. Optional: For easier authentication to GitHub, [generate an SSH
    key][github-ssh-keygen] and [add it to your GitHub account][github-add-key].
    Note: the `xclip` commands will probably not work. Instead, just run `cat
@@ -139,7 +139,7 @@ pull requests to ocfweb will use this same clone.
    very short name for your branch and run `git checkout -b <branch-name>`. You
    have now created and switched to your new branch.
 2. Now, you can edit the file and add your username. Figure out which file
-   corresponds to [the completion list](/staff-docs/get-involved/starter-tasks/completed/) and
+   corresponds to [the completion list](completed.md) and
    add your username to that file. (Just add the name for now, don't worry about
    adding the URL or brackets.)
 
@@ -200,7 +200,7 @@ After pushing, the pull request on GitHub will automatically update with the new
 changes.
 
 Congrats on making your PR! If you want to learn more about what you can do with
-git, check out our [documentation on git](/staff-docs/infrastructure/git/).
+git, check out our [documentation on git](../../infrastructure/git.md).
 
 [github-pull-request]: https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/about-pull-requests
 [ocfweb]: https://github.com/ocf/ocfweb

docs/staff-docs/index.md

@@ -6,4 +6,4 @@ The documentation in this section is for current and prospective OCF staff to le
 
 Feel free to attend our meetings, visit us during staff hours, or contact us by email.
 
-Regular OCF users looking for help should go to the [user docs](../user-docs) instead.
+Regular OCF users looking for help should go to the [user docs](../user-docs/index.md) instead.

docs/staff-docs/infrastructure/git.md

@@ -17,7 +17,7 @@ assume that development is happening in a single branch.
 work if you have permission and change the author appropriately (e.g.,
 `--author="Guest User <guser@ocf.berkeley.edu>"`). When committing, `git config
 user.name` should be your name and `git config user.email` should be your OCF
-email address -- this should be taken care of by [LDAP](/staff-docs/infrastructure/ldap/) and `/etc/mailname` on OCF machines.
+email address -- this should be taken care of by [LDAP](ldap.md) and `/etc/mailname` on OCF machines.
 
 ### To "update"
 

docs/staff-docs/infrastructure/internal-firewalls.md

@@ -2,7 +2,7 @@
 title: Internal Firewalls
 ---
 
-While the [external firewall](/staff-docs/infrastructure/firewall/) regulates network
+While the [external firewall](external-firewall.md) regulates network
 traffic to the OCF from outside the OCF network, internal firewalls are
 responsible for regulating network traffic between different machines within the
 OCF.

docs/staff-docs/infrastructure/kubernetes/index.md

@@ -25,7 +25,7 @@ replication, impose resource limits, and recover quickly from failures.
 
 A Kubernetes cluster consists of "master" nodes and "worker" nodes. In short,
 master nodes share state to manage the cluster and schedule jobs to run on
-workers. [It is considered best practice to run an odd number of masters](/staff-docs/infrastructure/kubernetes/#why-the-odd-number-of-masters), and currently our
+workers. [It is considered best practice to run an odd number of masters](#why-the-odd-number-of-masters), and currently our
 cluster has three masters.
 
 ### Masters

docs/staff-docs/infrastructure/ldap.md

@@ -6,7 +6,7 @@ title: LDAP
 
 The Lightweight Directory Access Protocol accesses a directory service over a
 network. We currently use OpenLDAP to store information about accounts (except
-password hashes which are in [Kerberos](/staff-docs/infrastructure/kerberos/)).
+password hashes which are in [Kerberos](kerberos.md)).
 
 
 ## Definition of an OCF account
@@ -91,7 +91,7 @@ Searching for all accounts created after a certain time:
 ### `ldapvi`
 
 `ldapvi` is a "text editor" for LDAP which can generate LDIF change records to
-pass to `ldapadd` (or modify directly if you have the proper [permissions](/staff-docs/get-involved/staff-privileges/)). The easiest way to edit a single record with `ldapvi` is to
+pass to `ldapadd` (or modify directly if you have the proper [permissions](../get-involved/staff-privileges.md)). The easiest way to edit a single record with `ldapvi` is to
 just run `kinit [username]/admin ldapvi [record]`, which will authenticate with
 Kerberos and then run `ldapvi` all in one step.
 
@@ -129,7 +129,7 @@ file in your current directory, or `Q` to discard.
 ### `ldapadd`
 
 `ldapadd` is a utility to add entries to the LDAP directory if you have the
-proper [permissions](/staff-docs/get-involved/staff-privileges/).
+proper [permissions](../get-involved/staff-privileges.md).
 
 To add an account, first create a file (we call it `user_file`):
 
@@ -145,7 +145,7 @@ To add an account, first create a file (we call it `user_file`):
     loginShell: /bin/bash
     calnetUid: 758472
 
-Then authenticate with [Kerberos](/staff-docs/infrastructure/kerberos/):
+Then authenticate with [Kerberos](kerberos.md):
 
     $ kinit myusername/admin