Merge #527 #528

527: Clarify dense property of DenseVecStorage r=torkleyy a=torkleyy

Fixes #484

<!-- Reviewable:start -->
---
This change is [<img src="https://reviewable.io/review_button.svg" height="34" align="absmiddle" alt="Reviewable"/>](https://reviewable.io/reviews/slide-rs/specs/527)
<!-- Reviewable:end -->


528: Fix grammar of RestrictedStorage docs r=torkleyy a=torkleyy

Fixes #491

<!-- Reviewable:start -->
---
This change is [<img src="https://reviewable.io/review_button.svg" height="34" align="absmiddle" alt="Reviewable"/>](https://reviewable.io/reviews/slide-rs/specs/528)
<!-- Reviewable:end -->


Co-authored-by: Thomas Schaller <torkleyy@gmail.com>

src/storage/restrict.rs

@@ -33,8 +33,8 @@ impl ImmutableAliasing for SequentialRestriction {}
 impl ImmutableAliasing for ImmutableParallelRestriction {}
 
 /// Similar to a `MaskedStorage` and a `Storage` combined, but restricts usage
-/// to only getting and modifying the components. That means nothing that would
-/// modify the inner bitset so the iteration cannot be invalidated. For example,
+/// to only getting and modifying the components. That means it's not possible to
+/// modify the inner bitset so the iteration cannot be invalidated. In other words,
 /// no insertion or removal is allowed.
 ///
 /// Example Usage:

src/storage/storages.rs

@@ -78,6 +78,9 @@ unsafe impl<T> DistinctStorage for HashMapStorage<T> {}
 /// Dense vector storage. Has a redirection 2-way table
 /// between entities and components, allowing to leave
 /// no gaps within the data.
+///
+/// Note that this only stores the data (`T`) densely; indices
+/// to the data are stored in a sparse `Vec`.
 #[derive(Derivative)]
 #[derivative(Default(bound = ""))]
 pub struct DenseVecStorage<T> {