Examples

What WikiFix found in the Sourcegraph Handbook (archived July 2024)

github.com/sourcegraph/handbook · 901 pages scanned · 86 places where pages disagree · a sample of 10

A company handbook: security policy, pay, support rules and engineering runbooks.

Sourcegraph archived this handbook on GitHub in July 2024 and moved it to Notion; most quotes here are from the archive.

Policy and process

Who may sign off an exception for a High or Medium risk with no reasonable treatment?

CTO
… In this case, an exception should be sought. Exceptions can only be signed off by the CTO.
– Security risk management process
risk committee
Exceptions must have the signoff from the risk committee on an individual basis.
– Information Security Risk Management Policy

The process page and the policy page name different people who can sign off a risk exception.

WikiFix finding: "Who may sign off an exception for a High or Medium risk with no reasonable treatment?" – one page says "CTO", one page says "risk committee". Options to pick an answer, ask the page owner, or ignore.

After how many minutes of inactivity does a Sourcegraph laptop lock?

10 minutes
Your laptop screen is set to lock after 10 Minutes of inactivity.
– Computer standards (tech ops security)
5 minutes
Change your laptop screen lock time from 5 Minutes (Sourcegraph standards) to 1 or 2 minutes
– Travel tips (tech ops security)

A security standard. The travel page states the standard as 5 minutes and links to the standards page, which says 10.

WikiFix finding: "After how many minutes of inactivity does a Sourcegraph laptop lock?" – one page says "10 minutes", one page says "5 minutes". Options to pick an answer, ask the page owner, or ignore.

What is the definition of a backlog?

an unordered set of work with no associated target or commitment dates
Backlog: An unordered set of work with no associated target or commitment dates.
– Product planning (Engineering)
the ordered list of items to be tackled after items on the roadmap are complete
Backlog: The ordered list of items to be tackled after items on the roadmap are complete
– Product Management Process

Engineering and product define the same word in opposite ways: unordered versus ordered.

WikiFix finding: "What is the definition of a backlog?" – one page says "an unordered set of work with no associated target or commitment dates", one page says "the ordered list of items to be tackled after items on the roadmap are complete". Options to pick an answer, ask the page owner, or ignore.

Sales and customers

Which SLA defines support priority p0?

the p0 SLA
… p0: All customer reported issues per our contractual p0 service level agreement definition here (even Cloud customers, though we don't have SLAs for them at this time).
– Support prioritization (Support Team Processes)
the p1 SLA
se/p0: All customer reported issues per our contractual p1 service level agreement definition here.
– Engaging Other Teams

One page defines priority 0 by the priority 1 agreement. A support engineer reading it commits to the wrong response time.

WikiFix finding: "Which SLA defines support priority p0?" – one page says "the p0 SLA", one page says "the p1 SLA". Options to pick an answer, ask the page owner, or ignore.

What proportion of HubSpot contacts are synced to Salesforce?

All
All HubSpot contacts are synced to Salesforce, usually within 15 minutes.
– How we use Salesforce (sales tools)
Most
Most HubSpot contacts are synced to Salesforce, usually within 15 minutes.
– Marketing operations (sales ops)

A rep who believes every contact reaches Salesforce will never look for the ones a suppression list quietly blocks.

WikiFix finding: "What proportion of HubSpot contacts are synced to Salesforce?" – one page says "All", one page says "Most". Options to pick an answer, ask the page owner, or ignore.

People, hiring, and pay

How often are compensation ranges reset?

every six months
A: We re-run compensation ranges every 6-months, and our ranges move as the market moves.
– Manager Guide - Delivering the Impact Review
every 12 months
We re-evaluate our compensation ranges every 12 months, in alignment with our Impact Review Process, to ensure our compensation remains up-to-date and market competitive.
– Compensation & Pay Transparency at Sourcegraph

The pay page says yearly; the manager guide says every six months.

WikiFix finding: "How often are compensation ranges reset?" – one page says "every six months", one page says "every 12 months". Options to pick an answer, ask the page owner, or ignore.

How often are impact reviews conducted?

twice-yearly
Feedback and career growth conversations are ongoing, and not limited to our twice-yearly impact review cycles.
– Manager Guide - Delivering the Impact Review
… our bi-annual impact reviews provide a great opportunity where in-depth, formal feedback can be provided both ways: teammate-to-manager, as well as manager-to-teammate …
– Impact review writing - guidelines & examples
annually in February
While we expect our Managers to provide ongoing feedback with Teammates year-round in 1:1 meetings and informally, we also provide formal feedback via our annual "impact review" process, which takes place in February.
– Impact review cycles

The review-cycle page and the manager guide disagree on how often reviews happen.

WikiFix finding: "How often are impact reviews conducted?" – one page says "twice-yearly", one page says "annually in February". Options to pick an answer, ask the page owner, or ignore.

Engineering and configuration

Do Cloud customers need to self-host executors for server-side batch changes?

No
Running batch changes server-side is available both for self-hosted and Sourcegraph Cloud customers.
– Running batch changes server-side is moving to beta
All Cloud instances have executors enabled by default, enabling the use of Server Side Batch Changes and Code Intel auto-indexing.
– Cloud Operations Team
Yes
Today, running batch changes server-side is available on Cloud (formerly managed instances), provided that customers self-host executors.
– Batch Changes strategy

A strategy page and a release note disagree on what Cloud customers have to run themselves.

WikiFix finding: "Do Cloud customers need to self-host executors for server-side batch changes?" – one page says "No", one page says "Yes". Options to pick an answer, ask the page owner, or ignore.

What is the kubectl command to scale codeintel-db?

kubectl scale codeintel-db --replicas=1
… sts ---all --replicas=0 Then restart ONLY the pgsql and codeintel pods Start the pgsql: kubectl scale pgsql --replicas=1 Start the codeintel-db: kubectl scale codeintel-db --replicas=1 Copy the database files into the pods by running the following command from the root of the deploy-sourcegraph directory kubectl cp …
– How to Migrate Sourcegraph from one cluster to another.
kubectl scale deployment/codeintel-db --replicas=1
… replicas=0 Then restart ONLY the pgsql and codeintel pods Start the pgsql: kubectl scale deployment/pgsql --replicas=1 Start the codeintel-db: kubectl scale deployment/codeintel-db --replicas=1 Copy the database files into the pods by running the following command from the root of the deploy-sourcegraph directory kubectl cp …
– How to Migrate Sourcegraph from one cluster to another.

Two copies of the same runbook; one command is missing the deployment prefix.

WikiFix finding: "What is the kubectl command to scale codeintel-db?" – one page says "kubectl scale codeintel-db --replicas=1", one page says "kubectl scale deployment/codeintel-db --replicas=1". Options to pick an answer, ask the page owner, or ignore.

Tools and operations

What is the invoice submission email address for Sourcegraph?

ap@sourcegraph.comp
Contractors submit an invoice at the end of each month (including any reimbursable and recurring expenses) via email to our accounting team, ap@sourcegraph.comp .
– How we engage talent outside of the US
ap@sourcegraph.com
All invoices should be sent via email to our accounting team, ap@sourcegraph.com All invoices will be paid through Airbase .
– Submitting an invoice (teammates based outside of US)

One character. Invoices sent to the first address don't arrive.

WikiFix finding: "What is the invoice submission email address for Sourcegraph?" – one page says "ap@sourcegraph.comp", one page says "ap@sourcegraph.com". Options to pick an answer, ask the page owner, or ignore.

Run it on your own spaces.

Your first scan produces the same kind of report for your spaces, and reading it changes nothing on your pages.