make corrections and improvements to apidocs (no code changes)

website/server/controllers/api-v3/user/spells.js

@@ -30,29 +30,30 @@ const api = {};
  *                  the necessary fields will be populated. The user is always returned.
  *
  * @apiDescription Skill Key to Name Mapping
- * Mage
- * fireball: "Burst of Flames"
- * mpheal: "Ethereal Surge"
- * earth: "Earthquake"
- * frost: "Chilling Frost"
  *
- * Warrior
- * smash: "Brutal Smash"
- * defensiveStance: "Defensive Stance"
- * valorousPresence: "Valorous Presence"
- * intimidate: "Intimidating Gaze"
+ * Mage:
+ * fireball="Burst of Flames",
+ * mpheal="Ethereal Surge",
+ * earth="Earthquake",
+ * frost="Chilling Frost"
  *
- * Rogue
- * pickPocket: "Pickpocket"
- * backStab: "Backstab"
- * toolsOfTrade: "Tools of the Trade"
- * stealth: "Stealth"
+ * Warrior:
+ * smash="Brutal Smash",
+ * defensiveStance="Defensive Stance",
+ * valorousPresence="Valorous Presence",
+ * intimidate="Intimidating Gaze"
  *
- * Healer
- * heal: "Healing Light"
- * protectAura: "Protective Aura"
- * brightness: "Searing Brightness"
- * healAll: "Blessing"
+ * Rogue:
+ * pickPocket="Pickpocket",
+ * backStab="Backstab",
+ * toolsOfTrade="Tools of the Trade",
+ * stealth="Stealth"
+ *
+ * Healer:
+ * heal="Healing Light",
+ * protectAura="Protective Aura",
+ * brightness="Searing Brightness",
+ * healAll="Blessing"
  *
  * @apiError (400) {NotAuthorized} Not enough mana.
  * @apiUse TaskNotFound

website/server/controllers/api-v3/user/stats.js

@@ -5,8 +5,7 @@ import { authWithHeaders } from '../../../middlewares/auth';
 const api = {};
 
 /**
- * @api {post} /api/v3/user/allocate Allocate a single Stat Point
- * (previously called Attribute Point)
+ * @api {post} /api/v3/user/allocate Allocate a single Stat Point (previously called Attribute Point)
  * @apiName UserAllocate
  * @apiGroup User
  *