Open trickeydan opened 6 years ago
Why are we duplicating the content rather than just linking to the existing docs?
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.
What other docs on roles?
If you mean SRs docs for this, I have several justifications for this:
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.
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.
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
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
Based loosely on the information I could find in the SR docs.