sourcebots / volunteer-docs

Documentation and Information for Volunteers
https://volunteering.sourcebots.co.uk
1 stars 1 forks source link

Add information on competition roles #46

Open trickeydan opened 6 years ago

trickeydan commented 6 years ago

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

RealOrangeOne commented 6 years ago

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

mildlyincompetent commented 6 years ago

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 commented 6 years ago

What other docs on roles?

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

RealOrangeOne commented 6 years ago

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 commented 6 years ago

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 commented 6 years ago

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 commented 6 years ago

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