Update OverworldEditor documentation and others

src/app/editor/overworld_editor.h

@@ -12,12 +12,12 @@
 #include "absl/status/statusor.h"
 #include "absl/strings/str_format.h"
 #include "app/core/common.h"
-#include "app/editor/utils/editor.h"
 #include "app/editor/context/entrance_context.h"
 #include "app/editor/context/gfx_context.h"
 #include "app/editor/modules/gfx_group_editor.h"
 #include "app/editor/modules/palette_editor.h"
 #include "app/editor/modules/tile16_editor.h"
+#include "app/editor/utils/editor.h"
 #include "app/gfx/bitmap.h"
 #include "app/gfx/snes_palette.h"
 #include "app/gfx/snes_tile.h"
@@ -64,13 +64,18 @@ constexpr absl::string_view kOWMapTable = "#MapSettingsTable";
 
 /**
  * @class OverworldEditor
- * @brief Represents an editor for the overworld in a game.
+ * @brief Manipulates the Overworld and OverworldMap data in a ROM.
  *
  * The `OverworldEditor` class is responsible for managing the editing and
- * manipulation of the overworld in a game. It inherits from various base
+ * manipulation of the overworld in a game. The user can drag and drop tiles,
- * classes and provides functionality for updating, drawing, and handling user
+ * modify OverworldEntrance, OverworldExit, Sprite, and OverworldItem
- * interactions with the overworld. It also includes methods for loading
+ * as well as change the gfx and palettes used in each overworld map.
- * graphics, refreshing map data, and performing various editing operations.
+ *
+ * The Overworld itself is a series of bitmap images which exist inside each
+ * OverworldMap object. The drawing of the overworld is done using the Canvas
+ * class in conjunction with these underlying Bitmap objects.
+ *
+ * Provides access to the GfxGroupEditor and Tile16Editor through popup windows.
  *
  */
 class OverworldEditor : public Editor,

src/app/editor/sprite_editor.h

@@ -10,8 +10,8 @@ namespace app {
 namespace editor {
 
 /**
- * @brief The SpriteEditor class represents a sprite editor that inherits from
+ * @class SpriteEditor
- * SharedROM.
+ * @brief Allows the user to edit sprites.
  *
  * This class provides functionality for updating the sprite editor, drawing the
  * editor table, drawing the sprite canvas, and drawing the current sheets.

src/app/gui/canvas.h

@@ -11,6 +11,11 @@
 
 namespace yaze {
 namespace app {
+
+/**
+ * @namespace yaze::app::gui
+ * @brief Graphical User Interface (GUI) components for the application.
+ */
 namespace gui {
 
 using app::gfx::Bitmap;

src/app/zelda3/common.h

@@ -4,11 +4,15 @@
 namespace yaze {
 namespace app {
 /**
- * @namespace zelda3
+ * @namespace yaze::app::zelda3
  * @brief Zelda 3 specific classes and functions.
  */
 namespace zelda3 {
 
+/**
+ * @class OverworldEntity
+ * @brief Base class for all overworld entities.
+ */
 class OverworldEntity {
  public:
   enum EntityType {

src/app/zelda3/sprite/sprite.h

@@ -19,6 +19,10 @@ namespace yaze {
 namespace app {
 namespace zelda3 {
 
+/**
+ * @class Sprite
+ * @brief A class for managing sprites in the overworld and underworld.
+ */
 class Sprite : public OverworldEntity {
  public:
   Sprite() = default;