Skip to content
This repository was archived by the owner on Aug 15, 2019. It is now read-only.
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -131,3 +131,6 @@ typings/


# End of https://www.gitignore.io/api/node,hugo,intellij

# windows files
Thumbs.db
9 changes: 9 additions & 0 deletions .spelling
Original file line number Diff line number Diff line change
@@ -1 +1,10 @@
SourceBots
sourcebots.co.uk

#organisations
Github
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

GitHub style their name with a capital H, which we should probably stick with.

Trello
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

should Google be here too?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Isn't Google a common enough word to be picked up by spell checkers?

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If the spell checker doesn't complain about it, we can assume so!


#slack channels
sb-2018
soton
51 changes: 51 additions & 0 deletions content/essential-knowledge/software-platforms.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,51 @@
---
title: Software and communications Platforms.
---

## Mailing list

The mailing list is used for important announcements such as meetings and discussions where input is required from volunteers.
The mailing list is public so sensitive information should not be placed here.

You can sign up for the mailing list at https://groups.google.com/forum/#!forum/sourcebots

## Slack
Slack is used for quick messaging and non-critical communications.
It should not be assumed that messages will be read by everyone, for important messages use the mailing list instead.

Sign up at https://sourcebots.slack.com

#### Some Notable channels
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would this be better solved by making the "notable" channels the defaults for new people on slack? That avoids the need to keep two places in sync (both in terms of what the list is and the documentation of each element).

* general general discussion not competition related
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd be interested in exploring setting these to links to the room URLs directly. Also, it might look nicer prefixed with a hash, although i'm not sure if markdown will format those incorrectly?

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Either way, room names need some kind of emphasis or seperation from their descriptions

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I quite like formatting slack room names like this: #general

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The hash prefix and hyperlink is nice, however does make the content noisy. Perhaps just bold and hash for now will do, and a shortcode helper later down the line might be nice!

* meetings discussion on upcoming meetings
* getting-involved How to get involved with SourceBots organisation / development
* sb-2018 organisation for the 2018 competition
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

might be worth changing this to "sb-20xx" where xx finishes the year... it means we won't have to change this every time

* soton discussion for Southampton specific things

## Trello

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Might it be worth noting that Trello tasks are assigned to people ?

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Trello tasks arent often assigned to people. Unless there's specific knowledge or access, theyre unassigned, so people can pick them up when they wish

Trello is mainly used for strategic planning.
Trello tasks will refer to things such as milestones on Github issues or other similar objectives, components of features, issues and bugs should be in the components issue tracker rather than Trello.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

GitHub

Some Trello boards however will be used for tracking small tasks on things that don’t have a separate issue tracker.

Trello can be accessed at https://trello.com/smallpeice2016


## Github
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

GitHub


Github is the main storage location for our version controlled code.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

GitHub

It also provides issue tracking for the included repositories.

The SourceBots Github organisation can be found at https://github.com/sourcebots
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

GitHub (Sorry) XD


## Google Docs

The google docs folder is used to store information that cannot or should not be stored publicly.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Google


https://drive.google.com/drive/folders/0Bx0mcmIgOQ42YVdaOU0yZ3IzMVk


## SourceBots emails

sourcebots.co.uk Email addresses issued for those interacting with teams or similar needs.
If you have a need of one ask at a meeting and one will be created for you.