Add information on competition roles by trickeydan · Pull Request #46 · sourcebots/volunteer-docs

trickeydan · 2018-04-08T17:49:47Z

Based loosely on the information I could find in the SR docs.

Also removed the individual, blank role pages.

anton-firmware

bees

anton-firmware · 2018-04-09T00:23:38Z

+---
+
+**Responsible for commentating matches and building a large amount of excitement amongst those near the arenas.**
+


Commentators also aren't allowed to make judgements on matches (i.e. if they are to be replayed, restarted or on any scoring decisions) - this was in SR documentation for previous years... :)

I think this is implied as it isn't explicitly mentioned as something that a commentator should do.

I can imagine people saying that the docs should be as explicit as possible...

This will be described in the Judge role when that content is written.

Given that the docs below do mention a related thing which the commentator shouldn't do (announcements to volunteers), I think it's reasonable to include here things which the commentator doesn't do.
I don't think we should assume that the commentator has read the docs for other roles.

How about (in place of the last sentence below, possibly as a separate paragraph):

As a commentator your role is to communicate to the competitors. Note that making decisions about the outcome of matches and communicating to volunteers are the responsibilities of other roles.

anton-firmware · 2018-04-09T00:24:30Z

@@ -1,3 +0,0 @@
---


why was this page removed? XD

I don't think an entire extra page is required for a role that can be summarised in a single sentence.

what if we were to fill the rest of the page with 🐝 ???
(on a serious note, you'd be surprised. SR managed to use more than a sentence)

Yes, much more than a single sentence that we do not require at this point in time. We are currently focusing on documenting the core roles that are likely to be on a rota.

I strongly agree with Anton's suggestion of 🐝 🐝 🐝 🐝 🐝 🐝 🐝 🐝 🐝 🐝 🐝 🐝 🐝 🐝 🐝 🐝 🐝 🐝 🐝 🐝 🐝 🐝 🐝 🐝 🐝 🐝 🐝 🐝 🐝 🐝 🐝 🐝 🐝 🐝 🐝 🐝 🐝 🐝

anton-firmware · 2018-04-09T00:24:41Z

@@ -1,3 +0,0 @@
---


ditto the roving helper comment...

This is because the information has yet to be found and will likely follow in a later PR after discussion at a meeting.
The SR docs on Shepherding are not really that great for us as they are written for a much larger scale event with lots of bureaucracy .

RealOrangeOne · 2018-04-09T18:27:38Z

Why are we duplicating the content rather than just linking to the existing docs?

mildlyincompetent · 2018-04-09T18:41:46Z

There's no existing SourceBots docs on this topic I believe? We shouldn't be relying on third party docs that we cannot modify to describe our organisation, and I can't find any other docs we've written on this.

trickeydan · 2018-04-09T18:43:03Z

What other docs on roles?

If you mean SRs docs for this, I have several justifications for this:

We are not SR, we have our own docs.
We have no control over that documentation
It is not entirely duplicate information, it is slightly different in some places.
The SR documentation on this is not searchable, and incredibly difficult to navigate.

RealOrangeOne · 2018-04-09T18:49:13Z

If that's the case, then our documentation should be far more detailed than it currently is, and there's a lot more work to do. I wouldnt be happy shipping these role guides until theyre actually complete.

mildlyincompetent · 2018-04-09T18:53:17Z

Hasn't our approach in general been that it's better for some documentation on a topic to exist rather than none? Currently no SourceBots documentation exists on the topic of competition roles, so this should at least be a good start.

Adimote · 2018-04-09T19:14:46Z

This is the volunteer docs (and should behave like a wiki), so I think it's okay to ship information which needs more detail added than not ship anything at all, assuming there's a trello card or something saying more detail should be added

Adimote · 2018-04-09T19:15:36Z

I don't think it's a good idea to link to SR's docs as it will contain incorrect information in the context of SB

RealOrangeOne · 2018-04-15T14:09:31Z

+hidden: true
+---
+
+**Responsible for commentating matches and building a large amount of excitement amongst those near the arenas.**


Why is this bold?

This section is also bold on the other individual pages for roles.

I would rather we use h2 for things like this

This is content, not a heading. h2 would be inappropriate.

RealOrangeOne · 2018-04-15T14:12:27Z

+
+Some roles are scheduled on a rota, generally these are the more important roles that are required for the competition to function.
+
+## Role Descriptions


I suggest we state that this isn't an exhaustive list, and that there are some roles (tech deck people, event announcer etc) which arent documented.

PeterJCLaw · 2018-04-15T14:31:19Z

+
+**Responsible for receiving scores from the match scorers and entering them into the competition software.**
+
+In the role of score entry you will be stationed at a desk near to the arena/staging area. When a score sheet is given to you by the match scorers, you will enter the scores into a computer and then file the score sheet in a folder.


Will they really be by the arena? They almost certainly want to be somewhere out of the way and quiet.
Historically this means that they have been on the Cube balcony.

This information was taken from the student robotics documentation on this role. I am happy to change it if needed.

At newbury, the scoring desk is next to the arena, yes. In the cube, it's often on the balcony, near the tech desk etc. I suggest we keep it there, so the cube floor is free.

On a related note, is there actually a need to say where the position is going to be in this? The entry people will be near the score entry desk, which will be wherever, we don't need anything more than that.

trickeydan added 3 commits April 8, 2018 17:23

Add non-complete list of roles

ac18228

Also removed the individual, blank role pages.

Add brief descriptions to the roles

bcf9ccb

Add additional details to some roles

582d27f

trickeydan requested review from Adimote, PeterJCLaw and anton-firmware April 8, 2018 17:49

trickeydan and others added 3 commits April 8, 2018 18:52

Add 'Helpdesk' to spelling file

8360add

Merge branch 'master' into competition-roles

d39e845

Singularify Roving Helpers

5394aca

anton-firmware reviewed Apr 9, 2018

View reviewed changes

Remove link to SR docs

7c7cebf

Merge branch 'master' into competition-roles

c16af17

RealOrangeOne reviewed Apr 15, 2018

View reviewed changes

Make it clear that the list isn't exhaustive

8728a4e

PeterJCLaw reviewed Apr 15, 2018

View reviewed changes

		---

		Responsible for commentating matches and building a large amount of excitement amongst those near the arenas.


		Some roles are scheduled on a rota, generally these are the more important roles that are required for the competition to function.

		## Role Descriptions


		Responsible for receiving scores from the match scorers and entering them into the competition software.

		In the role of score entry you will be stationed at a desk near to the arena/staging area. When a score sheet is given to you by the match scorers, you will enter the scores into a computer and then file the score sheet in a folder.

Conversation

trickeydan commented Apr 8, 2018

Uh oh!

anton-firmware left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

RealOrangeOne commented Apr 9, 2018

Uh oh!

mildlyincompetent commented Apr 9, 2018

Uh oh!

trickeydan commented Apr 9, 2018

Uh oh!

RealOrangeOne commented Apr 9, 2018

Uh oh!

mildlyincompetent commented Apr 9, 2018

Uh oh!

Adimote commented Apr 9, 2018 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Adimote commented Apr 9, 2018

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

Adimote commented Apr 9, 2018 •

edited

Loading