Improve documentation

README.md

@@ -32,11 +32,11 @@ Sections:
 
 ## Quick start
 
-If you just want to write a GUI application in Rust (for the web or for native), go to <https://github.com/emilk/eframe_template/> and follow the instructions there!
+If you just want to write a GUI application in Rust (for the web or for native), go to <https://github.com/emilk/eframe_template/> and follow the instructions there! The official docs are at <https://docs.rs/egui>. For inspiration, check out the [the egui web demo](https://emilk.github.io/egui/index.html) and follow the links in it to its source code. There is also an excellent tutorial video at <https://www.youtube.com/watch?v=NtUkr_z7l84>.
 
 If you want to integrate egui into an existing engine, go to the [Integrations](#integrations) section.
 
-If you have questions, use [GitHub Discussions](https://github.com/emilk/egui/discussions). There is also [an egui discord server](https://discord.gg/JFcEma9bJq). If you want to contribute to egui, please read the [Contributing Guidelines](https://github.com/emilk/egui/blob/master/CONTRIBUTING.md)
+If you have questions, use [GitHub Discussions](https://github.com/emilk/egui/discussions). There is also [an egui discord server](https://discord.gg/JFcEma9bJq). If you want to contribute to egui, please read the [Contributing Guidelines](https://github.com/emilk/egui/blob/master/CONTRIBUTING.md).
 
 ## Demo
 

docs/README.md

@@ -0,0 +1,3 @@
+This folder contains the files required for the egui web demo hosted at <https://emilk.github.io/egui/>.
+
+The reason the folder is called "docs" is because that is the name that GitHub requires in order to host a web page from the `master` branch of a repository.

egui/src/ui.rs

@@ -119,6 +119,8 @@ impl Ui {
     }
 
     /// Style options for this `Ui` and its children.
+    ///
+    /// Note that this may be a different [`Style`] than that of [`Context::style`].
     #[inline]
     pub fn style(&self) -> &std::sync::Arc<Style> {
         &self.style

epi/src/lib.rs

@@ -187,7 +187,9 @@ pub trait App {
     }
 }
 
-/// Options controlling the behavior of a native window
+/// Options controlling the behavior of a native window.
+///
+/// Only a single native window is currently supported.
 #[derive(Clone)]
 pub struct NativeOptions {
     /// Sets whether or not the window will always be on top of other windows.