Skip to content
This repository has been archived by the owner on Jul 2, 2024. It is now read-only.

Commit

Permalink
Migration status, prepare for archival
Browse files Browse the repository at this point in the history
  • Loading branch information
jhchabran committed Jun 25, 2024
1 parent 49bc1de commit af896b8
Showing 1 changed file with 10 additions and 15 deletions.
25 changes: 10 additions & 15 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,25 +6,20 @@ The handbook is a living document and we expect every teammate to propose improv

All content is in [Markdown](https://www.markdownguide.org/getting-started/#what-is-markdown) files under the [📁 content](./content) folder.

## :warning: Ongoing migration to Notion.so
## :warning: Migration to Notion.so

We are in the process of moving the handbook over Notion.so. In the original spirit of the handbook, we want most pages to stay publicly accessible.
The handbook is hosted on Notion, and https://handbook.sourcegraph.com will redirect to the corresponding Notion.site.
Redirections listed in `data/notion_migration.yaml` are now handled through Cloudflare.

- If you intend to contribute to the handbook, please instead do so on the Notion corresponding page, or port it if that's not yet done.
- If you maintain a set of pages, please take some time to add the corresponding redirection to the Notion equivalent in [data/notion_migration.yaml].
Please reach-out to [#wg-notion](https://sourcegraph.slack.com/archives/C06T68DBMSA) to add a new one if:

### Plan
- It's a very important page that was relevant to customers.
- It's a very important page for the hiring process and emails are in-flight with those URLs.

- [x] Set up basic Notion structure
- [x] Port the most important pages
- [] Port the remaining content
- Populate redirections for important pages to their Notion equivalent.
- May 1st: pull request for content change are subject to strict review.
- Only necessary changes are allowed.
- May 15th: content changes are forbidden, only redirections are accepted.
- May 31th: repository is archived.
- `handbook.sourcegraph.com` is now serving Notion pages.
- Previously set redirections are ported from the application to Cloudflare page rules.
Please reach-out to [#discuss-dev-infra](https://sourcegraph.slack.com/archives/C04MYFW01NV) directly if:

- You need to scrub content from the handbook (incorrect content has been added before the repo was archived).
- You absolutely need to push some change, with a very valid reason for it.

### Need help editing?

Expand Down

0 comments on commit af896b8

Please sign in to comment.