Dev Guild channel guidelines

The dev guild is a Slack channel meant to encourage sharing knowledge, news and other topics related to the technologies we use at Storio Group. In order to keep the channel relevant and accessible for the entire tech organization, please keep the following guidelines in mind:

• Top level posts in the channel should be closely related to frameworks, libraries, techniques or processes we use within the APG engineering organization.
  • Product updates (We released version 10.5!) and service announcements (Our service is down until 5pm) are better suited for channels where all stakeholders are present.
• Try to not just post a link, but add a little explanation as to why it is relevant or interesting. This makes it easier for others to find your message later.
• Use Slack threads for discussion, and schedule a meeting later if a discussion is particularily interesting.
• Use Slack Posts or Github gists to create content that can only be viewed by APG members.

Some examples of excellent content for the channel:

• An internal blogpost about a post-mortem investigation of an incident your team handled.
• A link to a pull request you created as part of your dev/chapter day and an explanation why it is amazing.
• A link to a RFC you made for your team to show what you are working on and how your teams process works.
• An open question as to how others have handled certain situations before, e.g. “How do you organize your folders in Terraform?”

Some examples of good content for the channel:

• A link to a library or update for one of the tech stacks we use, with a note on how we could use it.
• A link to a blogpost or video related to APG tech you found interesting.
• A recommendation for a good book or course related to APG tech.