docs(stackable-versioned): Update usage guide (#864)

* docs(stackable-versioned): Update usage guide

* docs: Add action specific docs, add K8s docs

* chore: Add validation TODOs

* docs: Update top-level crate docs

* docs: Hide unused trait

* chore: Apply suggestions

Co-authored-by: Nick <[email protected]>

* chore(docs): Adjust wording

---------

Co-authored-by: Nick <[email protected]>

crates/stackable-versioned-macros/Cargo.toml

@@ -6,6 +6,10 @@ license.workspace = true
 edition.workspace = true
 repository.workspace = true
 
+# Enable all features to ensure content appears in the online documentation.
+[package.metadata."docs.rs"]
+all-features = true
+
 # cargo-udeps throws an error that these dependencies are unused. They are,
 # however, used in K8s specific test cases. This is a false-positive and an
 # apparent limitation of cargo-udeps. These entries can be removed once

crates/stackable-versioned-macros/src/attrs/common/item.rs

@@ -296,6 +296,7 @@ impl ItemAttributes {
     }
 }
 
+// TODO (@Techassi): Add validation for when default_fn is "" (empty path).
 /// For the added() action
 ///
 /// Example usage:
@@ -317,6 +318,10 @@ fn default_default_fn() -> SpannedValue<Path> {
     )
 }
 
+// TODO (@Techassi): Add validation for when from_name AND from_type are both
+// none => is this action needed in the first place?
+// TODO (@Techassi): Add validation that the from_name mustn't include the
+// deprecated prefix.
 /// For the changed() action
 ///
 /// Example usage: