Developer Insights org

Mission

Bring Sourcegraph’s insights into your codebase (Code Intel, Code Insights, and API docs), extended with other dev tools’ information, to where developers interact with code (sourcegraph.com, code hosts, and IDEs)

Teams

  1. Frontend platform: the maintenance and expansion of the Sourcegraph web application. We also define and maintain the standards and tooling for how we do web development at Sourcegraph.
  2. Extensibility: our code host and third-party integrations (including our browser extension) and our Sourcegraph extensions.
  3. Code insights: empowering data-driven decisions in engineering organizations.
  4. API docs: making Sourcegraph the standard developer reference for public code.

Members

Strategy for FY22

Updated 2020-03-08

The strategy is currently a work in progress and can be viewed here: Developer Insights FY22 Strategy (Only accessible to Sourcegraph teammates until finalized.)

Processes

Each team is afforded the freedom to operate as best they see fit to achieve their goals. The following processes apply to all teams in Developer Insights.

Communication

We recognize that frequent, open communication is key to the success of every team, especially in an all-remote environment. We default to asynchronous communication in Slack and GitHub issues over other mediums (video calls, emails, etc) as we are respectful of our teammates’ time.

In addition to team specific channels, we communicate in the following org-wide channels in Slack:

#developer-insights-org: Our daily standups (facilited through Geekbot) go into this channel as well as all non-work related commmunication. Random conversations, banter, jokes etc. are all welcome here.

#developer-insights-org-onboarding: This channel is dedicated to questions or thoughts that new teammates have while they onboard. It’s a safe space to simply think out load and the goal is to identify things that we can improve and things we should make more clear in the handbook.

#developer-insights-org-leadership: This channel is for the Engineering Managers, Product Managers and Product Designers to discuss higher-level matters impacting the whole org.

Events

We have a shared events calendar where the teams can add all their team specific events so everyone can easily see the events.

Daily Slack updates

Collaborating across timezones requires regular communication to keep each other updated on our progress, and coordinate work handoff if needed. We also use this opportunity to build camaraderie between team members by sharing some non-work related aspects of our lives with each other.

We use Geekbot to facilitate all this and these updates are purely for coordination within the team (as opposed to for external stakeholders). At the start of each working day, Geekbot will ask each teammate a set of questions and the responses will be posted in the [#developer-insights-org] Slack channel.

All teammates are expected to be part of this channel, and should read the updates, to learn what your teammates have been working on, and check if they need your help.

Status updates

Each Engineering Manager of the teams in the org is responsible for sending out a status update by the Monday following their team’s retrospective.

Health reports

The engineering managers are responsible for compiling a weekly health report (see example) for their team.

The report is a confidential update between the Director and the Engineering Managers and serves the following purpose: 1. Updates the director on how things are going at a high-level in the team 1. Identifies areas of concern that could lead to proactive intervention to mitigate concerns

The report is not used for judging the performance of the team or the manager, and its intention is solely to inform and trigger dialogue. Managers are not expected to provide exhaustive notes, rather high-level summaries are preferred.