From 79d575da10adeadc8e71b2154205cce5dd3a8785 Mon Sep 17 00:00:00 2001
From: Pcornat <pcornat@protonmail.com>
Date: Fri, 27 Feb 2026 22:10:35 +0100
Subject: [PATCH] Documentation

---
 include/billy_objects.hpp | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/include/billy_objects.hpp b/include/billy_objects.hpp
index 58ec363..f09b282 100644
--- a/include/billy_objects.hpp
+++ b/include/billy_objects.hpp
@@ -55,8 +55,22 @@ namespace character {
 
         static void from_json(const json &j, container &billy);
 
+        /*!
+         * \brief It inserts the object inside the sheet.
+         *
+         * This method changes values inside the sheet according to the book's rules.
+         * \param sheet sheet to insert object into
+         * \param objType the object to insert
+         * \return true: object inserted, false otherwise
+         */
         [[nodiscard]] bool insert_object(CharacterSheet &sheet, const billyEnums objType) noexcept;
 
+        /*!
+         * \brief
+         * \param sheet sheet to erase object from
+         * \param objToErase the object to erase
+         * \return true: object erased, false otherwise
+         */
         [[nodiscard]] bool erase_object(CharacterSheet &sheet, const billyEnums objToErase) noexcept;
 
         [[nodiscard]] static bool is_full(const CharacterSheet &sheet) noexcept;
@@ -72,6 +86,12 @@ namespace character {
 
         std::minus<std::uint32_t> minus;
 
+        /*!
+         * \brief
+         * \param arg object used to change values
+         * \param sheet sheet to change
+         * \param operation Operation to apply to change values
+         */
         static void change_carac(const billyObjects &arg,
                                  CharacterSheet &sheet,
                                  const std::function<uint32_t(uint32_t, uint32_t)> &operation) noexcept;