Document modules object + nativescript

Author: Bromeon

gdnative-core/src/nativescript/mod.rs

@@ -1,13 +1,23 @@
-//! Types and functions related to the NativeScript extension of GDNative.
+//! Functionality for user-defined types exported to the engine (native scripts)
+//!
+//! NativeScript allows users to have their own scripts in a native language (in this case Rust).
+//! It is _not_ the same as GDNative, the native interface to call into Godot.
+//!
+//! Symbols in this module allow registration, exporting and management of user-defined types
+//! which are wrapped in native scripts.
+//!
+//! If you are looking for how to manage Godot core types or classes (objects), check
+//! out the [`core_types`][crate::core_types] and [`object`][crate::object] modules, respectively.
 
-pub(crate) mod class_registry;
+mod class;
 mod emplace;
 mod macros;
 
-mod class;
+pub(crate) mod class_registry;
+pub(crate) mod type_tag;
+
 pub mod init;
 pub mod profiling;
-pub mod type_tag;
 pub mod user_data;
 
 pub use class::*;

gdnative-core/src/object/mod.rs

@@ -1,4 +1,10 @@
 //! Provides types to interact with the Godot `Object` class hierarchy
+//!
+//! This module contains wrappers and helpers to interact with Godot objects.
+//! In Godot, classes stand in an inheritance relationship, with the root at `Object`.
+//!
+//! If you are looking for how to manage user-defined types (native scripts),
+//! check out the [`nativescript`][crate::nativescript] module.
 
 use std::borrow::Borrow;
 use std::ffi::CString;