chore: improve wording in design doc and README

Remove unecessary warning in README. Since the tool isn't stable (not
1.0.0 yet) I think I'm ok with just making breaking changes. I can note
this in the next release, but I think so far I'm my only customer.

Author: ptsouchlos

README.md

@@ -4,8 +4,6 @@
 
 See the [design documentation](./docs/design.md) for more details on some of the differences between `embd` and `beman-submodule` as well as why those decisions were made.
 
-> **Breaking change:** `embd` used to store one config file for the whole project, at a root-level `.embd/embd.toml` (or, in older versions, `config.toml` + `embd.lock`). It now stores one `.embd` file per embedded folder instead — see [Configuration File](./docs/design.md#configuration-file). If `embd` detects a project still using the old root-level `.embd/` layout, it will now error instead of silently reporting nothing. There is no automated migration; convert existing entries to the new per-folder `.embd` file layout by hand.
-
 ## Installation
 
 Install the latest published release from [crates.io](https://crates.io/crates/embd-cli):

docs/design.md

@@ -16,15 +16,15 @@ The general idea is to pull the dependent repository as source into the parent r
 
 ### Commands
 
-| Command  |                 Description                 |                                                                                                                                                 Options                                                                                                                                                 |
-| :------: | :-----------------------------------------: | :-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
-|  `add`   |   Add a new embedded repo to the project.   | `folder`: Specify what subdirectory to put embed in. \n `allow-untracked`: Allow untracked files in the embed directory. \n `link`: The link to the project to include \n `rev`: Specify the commit,tag or branch to pull \n `include`: Glob patterns to include \n `exclude`: Glob patterns to exclude |
+| Command  |                   Description                   |                                                                                                                                                 Options                                                                                                                                                 |
+| :------: | :---------------------------------------------: | :-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
+|  `add`   |     Add a new embedded repo to the project.     | `folder`: Specify what subdirectory to put embed in. \n `allow-untracked`: Allow untracked files in the embed directory. \n `link`: The link to the project to include \n `rev`: Specify the commit,tag or branch to pull \n `include`: Glob patterns to include \n `exclude`: Glob patterns to exclude |
 | `update` | Update all embeds to match their pinned config. |                                          `rev`: Specify the commit, tag or branch to advance to \n `force`: Overwrite any local modification \n `overwrite`: Delete all untracked files (requries `force`) \n `quiet`: Print summaries, not each file updates.                                          |
-| `status` |       Show the status of all embeds.        |                                                                                                                           `quiet`: Should summaries per embed, not per file.                                                                                                                            |
+| `status` |         Show the status of all embeds.          |                                                                                                                           `quiet`: Should summaries per embed, not per file.                                                                                                                            |
 
 ### Configuration File
 
-`embd` stores one configuration file per embed, named `.embd`, inside the embedded folder itself — mirroring how [beman-submodule](https://github.com/bemanproject/beman-submodule) stores a `.beman_submodule` file inside each submodule it manages. There's no project-wide config file; `embd` discovers embeds by walking the project tree for `.embd` files.
+`embd` stores one configuration file per embed, named `.embd`, inside the embedded folder itself. This mirrors how [beman-submodule](https://github.com/bemanproject/beman-submodule) stores a `.beman_submodule` file inside each submodule it manages. There's no project-wide config file; `embd` discovers embeds by walking the project tree for `.embd` files.
 
 Each file has a `metadata` table with the remote repository URL, commit, and include/exclude filters, plus a `files` table of sha256 hashes per tracked file, used to detect local drift without re-pulling or cloning files from the remote. The embed's folder isn't stored in the file — it's implied by the file's own location.