Update the runbook

[jwflory]

Summary

Our amazing runbook is slowly starting to date itself – we need to work on updating it based on things we're putting into practice this year or have already changed in the last year

Explanation

The runbook was the holy grail for me and @Serubin when we took over the reins from @thenaterhood and @repkam09. We all know that we're not here forever, so making sure that we keep the runbook updated and current will be helpful not only for ourselves every semester, but also for any forthcoming people who end up running the club past our time too.

I think a sit-down conversation with Eboard first to figure out what we want to update is important first, then an individual or a pair could go through actually making the changes for a final review. Ideally, I think this should happen in 2171 (fall 2017) semester, but it's not exactly a mission-critical task. But the longer it's put off, the worse it will get.

[jwflory]

See issue about RITlug servers in RITlug/runbook#3. Closing issue there and migrating to here.

[jwflory]

Progress update

It was decided in an Eboard meeting to set up a Read the Docs site for our Runbook. Since voting on it, the UI / customization is done and a few docs are already updated. More progress will be made on writing these docs.

See the latest version here: runbook.ritlug.com

Infrastructure

@axk4545 @Serubin Both of you have a much better grip of our infrastructure environment than I do. Could I ask both of you to create pages about the machines in our environment in the style of this page (see the reST source for it here)? It would be great if both of you could work together on these pages, between Titan and TigerOS. It might also make more sense to document the different VMs that are in use too.

Roles

I'd also like to ask each member of executive board to write an article explaining their role and responsibilities. If you're tech-savvy, you can write this in reStructuredText and submit it as a PR to RITlug/runbook, or you can write it in a DOCX / ODT file and send it to me directly.

Placeholder pages can be found below:

• @jflory7: President
• @Serubin: Vice President
• @TaylorBowling: Secretary
• @fosspotato: Treasurer
• @axk4545: Project Coordinator

Resources

If you'd like to write it yourself in reStructuredText, here's some pages to help you:

• Quick reStructuredText reference
• reStructuredText style guide

[Serubin]

@jflory7 You'd think that I have a good grasp...

Will provide documentation on the host setup.

[axk4545]

@jflory7 we should also include in this issue updating our constitution or otherwise making it match the runbook.

[jwflory]

RITlug/runbook#24 and RITlug/runbook#25 assist towards closing this issue.

What's left to close this

• Administration
  • Managing CampusGroups Update 'Managing CampusGroups' page runbook#34
  • Club Binder Add new page: Event Management System runbook#32
  • Club Binder contents Add new page: Event Management System runbook#32
  • GitHub organization Add GitHub organization documentation runbook#26
• Events
  • Club Fairs Improve club fairs page to be more detailed and accurate runbook#42
  • Event Management System Add new page: Event Management System runbook#32
  • Meetings Update meetings page for 2018 runbook#45
• Infrastructure
  • IRC channel Modernize IRC channel SOP (contributes to RITlug/tasks#8) runbook#56
  • The Website @ct-martin
• Roles
  • Eboard: President Add new page: President role (closes #50) runbook#61
  • Eboard: Secretary Add new page: Secretary role (closes #51) runbook#62
• Tasks
  • Announcements Update Announcements Page runbook#66
  • Semester Checklist Semester checklist update runbook#57

[jrtechs]

Eboard Comment(9-10-18):
We want to update the run-book with our SOP for how we are using the GitHub project board.

We need to update the VP, president, secretary run-book pages with how we are planning the Eboard meeting with the project board.

[jwflory]

This task is blocked by RITlug/runbook#62 (pending changes by @icflournoy) and @ct-martin for the website and CampusGroups announcement page. Updating assignee list.

I'm also flagging this one for meeting follow-up to see if can break up the remaining work and try to close this task before the end of September.

[icflournoy]

2018-09-24 Eboard Meeting

Discussion

• Sunset announcements on website, link to archive, indicate that announcements take place on CampusGroups mailing list

Action Items

• Monday Oct 1st eboard meeting @Tjzabel drafts Announcements page
• Monday Oct 15th eboard meeting: @ct-martin drafts The Website page changes
• @jwflory will work on cleaning up / restructuring Meetings page when he adds the sign-in link docs

[jwflory]

RITlug/runbook#66 documents how to send an announcement. Unassigning @Tjzabel.

[icflournoy]

2018-10-17 Eboard Meeting

• Runbook now at MVP! It is relevant again.
• Website work tracked in Update Website Documentation runbook#52