Remove some old docs, cleanup some readmes

packages/core/src/global_context.rs

@@ -196,24 +196,19 @@ pub fn schedule_update_any() -> Arc<dyn Fn(ScopeId) + Send + Sync> {
 ///
 /// fn child_component() -> Element {
 ///     let original_scroll_position = use_signal(|| 0.0);
-///     use_effect((), move |_| {
-///         to_owned![original_scroll_position];
-///         async move {
-///             let window = web_sys::window().unwrap();
-///             let document = window.document().unwrap();
-///             let element = document.get_element_by_id("my_element").unwrap();
-///             element.scroll_into_view();
-///             original_scroll_position.set(window.scroll_y().unwrap());
-///         }
+///
+///     use_effect(move |_| async move {
+///         let window = web_sys::window().unwrap();
+///         let document = window.document().unwrap();
+///         let element = document.get_element_by_id("my_element").unwrap();
+///         element.scroll_into_view();
+///         original_scroll_position.set(window.scroll_y().unwrap());
 ///     });
 ///
-///     use_drop({
-///         to_owned![original_scroll_position];
+///     use_drop(move || {
 ///         /// restore scroll to the top of the page
-///         move || {
-///             let window = web_sys::window().unwrap();
-///             window.scroll_with_x_and_y(*original_scroll_position.current(), 0.0);
-///         }
+///         let window = web_sys::window().unwrap();
+///         window.scroll_with_x_and_y(*original_scroll_position.current(), 0.0);
 ///     });
 ///
 ///     rsx!{

packages/core/src/lib.rs

@@ -46,33 +46,6 @@ pub(crate) mod innerlude {
     pub type Element = Option<VNode>;
 
     /// A [`Component`] is a function that takes [`Properties`] and returns an [`Element`].
-    ///
-    /// Components can be used in other components with two syntax options:
-    /// - lowercase as a function call with named arguments (rust style)
-    /// - uppercase as an element (react style)
-    ///
-    /// ## Rust-Style
-    ///
-    /// ```rust, ignore
-    /// fn example(cx: Props) -> Element {
-    ///     // ...
-    /// }
-    ///
-    /// rsx!(
-    ///     example()
-    /// )
-    /// ```
-    ///
-    /// ## React-Style
-    /// ```rust, ignore
-    /// fn Example(cx: Props) -> Element {
-    ///     // ...
-    /// }
-    ///
-    /// rsx!(
-    ///     Example {}
-    /// )
-    /// ```
     pub type Component<P = ()> = fn(P) -> Element;
 }
 

packages/core/src/nodes.rs

@@ -20,11 +20,7 @@ pub type TemplateId = &'static str;
 
 /// The actual state of the component's most recent computation
 ///
-/// Because Dioxus accepts components in the form of `async fn() -> Result<VNode>`, we need to support both
-/// sync and async versions.
-///
-/// Dioxus will do its best to immediately resolve any async components into a regular Element, but as an implementor
-/// you might need to handle the case where there's no node immediately ready.
+/// If the component returned early (e.g. `return None`), this will be Aborted(None)
 pub enum RenderReturn {
     /// A currently-available element
     Ready(VNode),