Skip to content

Latest commit

 

History

History
154 lines (70 loc) · 6.33 KB

2. Communication.md

File metadata and controls

154 lines (70 loc) · 6.33 KB

📕 GitHub Octernship Partner Handbook

💬 Communicating in the program

Table of Contents

Overview ❇️

Welcome to the Part (1/3) of GitHub Octernship Partner handbook. In this section, you will understand how as a Partner you can communicate with students from the application phase to selection phase in the program.

GitHub Discussions 💬

GitHub Discussions are a great way to make public discussions and announcements during the selection phase of the Octernship. Community members can ask and answer questions, share updates, and have open-ended conversations. Discussions enable fluid, open conversation in a public forum. Discussions give space for more collaborative conversations by connecting and giving a more centralized area to connect and find information.

You can setup GitHub Discussions in:

  1. Your Project Repository: Useful for project-related discussions
  2. GitHub Education Discussions: A public discussion under the GitHub Education Community, suitable for public announcements.

Enabling GitHub Discussions on your repository ✅

Repository owners and people with write access can enable GitHub Discussions for a community on their public and private repositories. The visibility of a discussion is inherited from the repository the discussion is created in.
  1. On GitHub.com, navigate to the repository’s main page.
  2. Under your repository name, click Settings.

  1. Under "Features", click Set up discussions.

  1. Under "Start a new discussion," edit the template to align with the resources and tone you want to set for your community.
  2. Click Start discussion.

Enabling GitHub Discussions in your organization 💬

Organization owners can enable GitHub Discussions for their organization.

When you enable organization discussions, you will choose a repository in the organization to be the source repository for your organization discussions. You can use an existing repository or create a repository specifically to hold your organization's discussions. Discussions will appear both on the discussions page for the organization and on the discussion page for the source repository.

You can change the source repository at any time. If you change the source repository, discussions are not transferred to the new source repository.

  1. On GitHub.com, navigate to the main page of your organization.
  2. Under your organization name, click Settings.

  1. Under "Discussions", select Enable discussions for this organization.
  2. Select a repository to use as the source repository for your organization's discussions.

  1. Click Save.

Creating a new discussion 💬

Any authenticated user who can view the repository can create a discussion in that repository. Similarly, since organization discussions are based on a source repository, any authenticated user who can view the source repository can create a discussion in that organization.

  1. On GitHub.com, navigate to the main page of the repository or organization where you want to start a discussion.
  2. Under your repository or organization name, click Discussions.

  1. Click New discussion.

  1. Select the Select Category drop-down menu, and click a category for your discussion.

  1. Type a title and body for your discussion.

  1. Click Start discussion.

Promoting healthy conversations 👥

People with write permissions for the repository, or for the source repository for organization discussions, can help surface important conversations by pinning discussions, deleting discussions that are no longer useful or are damaging to the community, and transferring discussions to more relevant repositories owned by the organization. For more information, see "Managing discussions."

GitHub Octernships Discord 💖

GitHub Octernships Discord server is a private communication platform for selected students i.e. Octerns only. Invites to all Partners POC will be rolled out via email by GitHub Staff.

  • #Announcements: All Octernship announcements are made in this channel, including deadlines, Octernship Streams, or anything every Octern needs to know.
  • #general: This is a common channel for all Octerns to meet and greet each other and with the partners and GitHub team.
  • #Organization_NAME: This is a dedicated channel for your organisation and your Octerns. You can use this throughout the Octernship to communicate with the Octern. This is helpful during onboarding.

Note: GitHub Education Discord is for selected Octerns only, if you want to make a public announcement for the braoder student community consider using GitHub Discussions

Organization Platform 📥

Partners can choose to use their existing org communication platform related to the project with the student/Octern. We recommend using the GitHub Education Discord channel during onboarding.

Staff Communication (GitHub) 📧

All communication with GitHub Staff can be done via email partners-octernships@github.com

Handbook References 🔗