fix(selectable): update docs with warning about selectable usage

2 files changed, 20 insertions, 1 deletions

diff --git a/src/lib.rs b/src/lib.rs
index c1c41cf..d108c17 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -229,9 +229,20 @@ pub fn span<'a, Link>(
     text::Span::new(text)
 }
 
-/// Creates some [`Selectable`] with the given content.
+/// Creates some [`Selectable`] with the given content. This [`Selectable`] will make all inner
+/// [`Text`] or [`Rich`] change their behavior from an independent selectable to a global
+/// selectable which makes it so you can select across widgets and start selections out of bounds
+/// of widgets. This [`Selectable`] will also handle the 'ctrl + c' shortcut by getting all the
+/// selected text inside it and write it to the clipboard.
+///
+/// WARNING: You should only have one [`Selectable`] on your app, preferrably as the root of your
+/// app to make sure that any [`Text`] or [`Rich`] is inside it. Having multiple selectables or a
+/// selectable along side some [`Text`] or [`Rich`] is undefined behavior and even though the
+/// selection might look ok for you the copied text will probably not be what you expect.
 ///
 /// [`Selectable`]: crate::selectable::Selectable
+/// [`Text`]: crate::Text
+/// [`Rich`]: crate::text::Rich
 ///
 /// # Example
 /// ```no_run,ignore
diff --git a/src/selectable.rs b/src/selectable.rs
index 217f913..fc0e996 100644
--- a/src/selectable.rs
+++ b/src/selectable.rs
@@ -4,6 +4,10 @@
 //! for all selections contained inside it and writing to the [`Standard`] clipboard when there is
 //! some selection.
 //!
+//! WARNING: You should only have one [`Selectable`] on your app, preferrably as the root of your
+//! app to make sure that any [`Text`] or [`Rich`] is inside it. Having multiple selectables or a
+//! selectable along side some [`Text`] or [`Rich`] is undefined behavior and even though the
+//! selection might look ok for you the copied text will probably not be what you expect.
 //!
 //! [`Text`]: crate::Text
 //! [`Rich`]: crate::text::Rich
@@ -25,6 +29,10 @@ use crate::core::{
 /// for all selections contained inside it and writing to the [`Standard`] clipboard when there is
 /// some selection.
 ///
+/// WARNING: You should only have one [`Selectable`] on your app, preferrably as the root of your
+/// app to make sure that any [`Text`] or [`Rich`] is inside it. Having multiple selectables or a
+/// selectable along side some [`Text`] or [`Rich`] is undefined behavior and even though the
+/// selection might look ok for you the copied text will probably not be what you expect.
 ///
 /// [`Text`]: crate::Text
 /// [`Rich`]: crate::text::Rich