diff --git a/docs/dev/architecture.md b/docs/dev/architecture.md index d817a74eca7..ee8f9253e5a 100644 --- a/docs/dev/architecture.md +++ b/docs/dev/architecture.md @@ -463,7 +463,7 @@ Mind the code--architecture gap: at the moment, we are using fewer feature flags In Rust, it is easy (often too easy) to add serialization to any type by adding `#[derive(Serialize)]`. This easiness is misleading -- serializable types impose significant backwards compatability constraints. If a type is serializable, then it is a part of some IPC boundary. -You often don't have control over the over side of this boundary, so changing serializable types are hard. +You often don't control the other side of this boundary, so changing serializable types are hard. For this reason, the types in `ide`, `base_db` and bellow are not serializable by design. If such types need to cross an IPC boundary, then the client of rust-analyzer needs to provide custom, client-specific serialization format.