diff --git a/include/dpp/appcommand.h b/include/dpp/appcommand.h
index f02233de9f..27944ac3ed 100644
--- a/include/dpp/appcommand.h
+++ b/include/dpp/appcommand.h
@@ -412,7 +412,7 @@ struct DPP_EXPORT command_resolved {
 	 */
 	std::map<dpp::snowflake, dpp::guild_member> members;
 	/**
-	 * @brief Resolved guild member permissions
+	 * @brief Resolved total guild member permissions in the channel, including overwrites
 	 */
 	std::map<dpp::snowflake, uint64_t> member_permissions;
 	/**
diff --git a/include/dpp/cache.h b/include/dpp/cache.h
index f5bc2ad406..2f3b2c62fb 100644
--- a/include/dpp/cache.h
+++ b/include/dpp/cache.h
@@ -189,8 +189,8 @@ template<class T> class cache {
 	 * std::unordered_map<snowflake, guild*>& gc = c->get_container();
 	 * std::shared_lock l(c->get_mutex()); // MUST LOCK HERE
 	 * for (auto g = gc.begin(); g != gc.end(); ++g) {
-	 *	dpp::guild* gp = (dpp::guild*)g->second;
-	 *      // Do something here with the guild* in 'gp'
+	 *     dpp::guild* gp = (dpp::guild*)g->second;
+	 *     // Do something here with the guild* in 'gp'
 	 * }
 	 * ``` 
 	 * 
diff --git a/include/dpp/guild.h b/include/dpp/guild.h
index 311d4d6c14..3e6056cac4 100644
--- a/include/dpp/guild.h
+++ b/include/dpp/guild.h
@@ -220,7 +220,9 @@ class DPP_EXPORT guild_member {
 	bool has_animated_guild_avatar() const;
 
 	/**
-	 * @brief Returns the members's per guild avatar if they have one, otherwise returns an empty string
+	 * @brief Returns the members per guild avatar if they have one, otherwise returns an empty string
+	 *
+	 * @note per-server avatar is a nitro only feature so it might be not set. If you need the real user avatar, use user::get_avatar_url.
 	 * 
 	 * @param size The size of the avatar in pixels. It can be any power of two between 16 and 4096. If not specified, the default sized avatar is returned.
 	 * @return std::string avatar url or empty string