From af896b875dc91439c8b8319fc1e801b627376f05 Mon Sep 17 00:00:00 2001 From: Jean-Hadrien Chabran Date: Tue, 25 Jun 2024 10:36:04 +0200 Subject: [PATCH] Migration status, prepare for archival --- README.md | 25 ++++++++++--------------- 1 file changed, 10 insertions(+), 15 deletions(-) diff --git a/README.md b/README.md index f8f2e706214c..6e488e24abc6 100644 --- a/README.md +++ b/README.md @@ -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?