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

Migration status, prepare for archival #8961

Merged
merged 1 commit into from
Jun 25, 2024
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
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
Loading