| Table of Contents | ||
|---|---|---|
|
Permissions
Our Confluence is viewable by anyone without an account.
The homepage is https://uwarg-docs.atlassian.net/wiki/home which lists out all spaces.
Edit permissions are granted to those who meet https://uwarg-docs.atlassian.net/wiki/spaces/AD/pages/2318500191/Member+Definition?search_id=259a624f-0256-4e81-8077-418636f8edb5 as per Data Handling.
Permission to grant edit permission is given to subteam leads (and some project managers) who are expected to verify member definition satisfaction when adding people to our confluence.
Some documents are not publicly viewable and some are restricted to only certain members in accordance with https://uwarg-docs.atlassian.net/wiki/spaces/AD/pages/2303033499/Private+Communications?search_id=93f43f95-c8ea-4793-9bb8-892ad5b8ae05.
Note there are very very few of these pages.
Having admin doesnt let you see all locked confluence pages; locked pages need to be manually shared with desired recipients.
Use Case
Confluence is used by WARG for all of our:
...
We are unsure of a decision and would like scrutiny from others
We want to share and collaborate on our engineering process
We want people in the future to reference the material
When you arrive at a justification for any design decision please add into the confluence doc for future reference so that if anyone questions a design decision you have the answer ready to go
We don’t want to repeat ourselves over and over again saying the same information
For more details please see Approach to Documentation .
Why did someone link a confluence doc to me?
...
Should note confluence has a mobile app as well. If someone links you a doc please read it. Even if youve you've read it before it may have been updated recently! Most confluence docs are intended to be brief and digestible.
Linking a confluence document is not intended to be rude though can be easily perceived that way. This can be extremely discouraging, impersonal, and impolite. Please ensure when linking a confluence document maybe add some fluff as a preamble to ensure it is interpreted correctly, for example:
I believe <link> may answer this question, please have a look and let me know.
This information can be found in <link>. Please let me know if you have further questions.
I believe <link> contains relevant information to this conversation.
If you <link> doesn't make sense, please let me know and we can chat it out.
If I have a question where should I start?
...
A confluence doc, specifically the policy ones, are not intended to be a decree from directors, they are meant to be malleable and discussable! As time goes on we will gain more knowledge and therefore improve our systems. All confluence docs should have justification for the statements they pose. If such justification is not obvious please ask for clarification from others! Please ask specific questions to get specific answers/discussions; broad questions are generally addressable by confluence documentation! When new high level team policies are created they should be discussed in leads meetings to ensure the team agrees. If any major discussions need to happen for existing policies leads meeting is the place for that to occur!
Professionalism
Beware the WARG Confluence is completely public. Please do not use it (or other WARG resources) for personal (or any non-WARG) projects. Keep in mind Redistribution Policy . Further we like to send the WARG confluence to others (companies, student design teams, university, etc.) so ensure everything in confluence is professional.
We want to make sure that everyone is proud to present tidy, thorough, and well considered work, as well as making sure everyone is clear on where to find our documentation, especially the most critical documentation related to the operation and maintenance of our drones.