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

Commit 01851bf

Browse files
committed
Update README with migration instructions/plan
1 parent 6d5f7b6 commit 01851bf

File tree

1 file changed

+18
-0
lines changed

1 file changed

+18
-0
lines changed

README.md

+18
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,24 @@ The handbook is a living document and we expect every teammate to propose improv
66

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

9+
## :warning: Ongoing migration to Notion.so
10+
11+
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.
12+
13+
- 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.
14+
- 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].
15+
16+
### Plan
17+
18+
- ~Set up basic Notion structure~
19+
- ~Port the most important pages~
20+
- Port the remaining content
21+
- Populate redirections for important pages to their Notion equivalent.
22+
- May 15th: content changes are forbidden, only redirections are accepted.
23+
- May 31th: repository is archived.
24+
- `handbook.sourcegraph.com` is now serving Notion pages.
25+
- Previously set redirections are ported from the application to Cloudflare page rules.
26+
927
### Need help editing?
1028

1129
Ask in the [#handbook channel](https://app.slack.com/client/T02FSM7DL/CQ44Y7F4G) (for Sourcegraph team members), and/or [post an issue](https://github.com/sourcegraph/handbook/issues).

0 commit comments

Comments
 (0)