move all EOL comments on typepath names to dmdoc (#23928)

* move all EOL comments on typepath names to dmdoc

* Apply suggestions from code review

Co-authored-by: Luc <89928798+lewcc@users.noreply.github.com>

* Apply suggestions from code review

Co-authored-by: S34N <12197162+S34NW@users.noreply.github.com>

---------

Co-authored-by: Luc <89928798+lewcc@users.noreply.github.com>
Co-authored-by: S34N <12197162+S34NW@users.noreply.github.com>

code/modules/clothing/glasses/engine_goggles.dm

@@ -101,7 +101,8 @@
 			user.update_inv_l_hand()
 			user.update_inv_r_hand()
 
-/obj/item/clothing/glasses/meson/engine/tray //atmos techs have lived far too long without tray goggles while those damned engineers get their dual-purpose gogles all to themselves
+/// atmos techs have lived far too long without tray goggles while those damned engineers get their dual-purpose gogles all to themselves
+/obj/item/clothing/glasses/meson/engine/tray
 	name = "optical t-ray scanner"
 	icon_state = "trayson-t-ray"
 	item_state = "trayson-t-ray"

code/modules/clothing/gloves/colored_gloves.dm

@@ -14,7 +14,8 @@
 /obj/item/clothing/gloves/color/yellow/fake
 	siemens_coefficient = 1
 
-/obj/item/clothing/gloves/color/fyellow                             //Cheap Chinese Crap
+/// Cheap Chinese Crap
+/obj/item/clothing/gloves/color/fyellow
 	name = "budget insulated gloves"
 	desc = "These gloves are cheap copies of the coveted gloves, no way this can end badly."
 	icon_state = "yellow"

code/modules/clothing/gloves/rings.dm

@@ -44,7 +44,8 @@
 	material = "silver"
 	ring_color = "silver"
 
-/obj/item/clothing/gloves/ring/silver/blessed // todo
+/// todo
+/obj/item/clothing/gloves/ring/silver/blessed
 	name = "blessed silver ring"
 
 /obj/item/clothing/gloves/ring/gold

code/modules/clothing/head/beanie.dm

@@ -3,7 +3,8 @@
 
 //Plus a bobble hat, lets be inclusive!!
 
-/obj/item/clothing/head/beanie //Default is white, this is meant to be seen
+/// Default is white, this is meant to be seen
+/obj/item/clothing/head/beanie
 	name = "white beanie"
 	desc = "A stylish beanie. The perfect winter accessory for those with a keen fashion sense, and those who just can't handle a cold breeze on their heads."
 	icon_state = "beanie" //Default white

code/modules/clothing/head/misc_hats.dm

@@ -392,7 +392,8 @@
 	"Vox" = 'icons/mob/clothing/species/vox/head.dmi'
 	)
 
-/obj/item/clothing/head/stalhelm //Why do these exist - Because they aren't specifically Nazi Germany
+/// Why do these exist - Because they aren't specifically Nazi Germany
+/obj/item/clothing/head/stalhelm
 	name = "clown stalhelm"
 	desc = "The typical clown soldier's helmet."
 	icon_state = "stalhelm"
@@ -415,7 +416,8 @@
 	flags = BLOCKHAIR
 	flags_inv = HIDEEARS
 
-/obj/item/clothing/head/beret/purple //Fluff?
+/// Fluff?
+/obj/item/clothing/head/beret/purple
 	name = "Pierson Family Beret"
 	desc = " A purple beret, with a small golden crescent moon sewn onto it."
 	icon_state = "beret_purple"

code/modules/clothing/shoes/magboots.dm

@@ -94,7 +94,8 @@
 	magboot_state = "syndiemag"
 	origin_tech = "magnets=4;syndicate=2"
 
-/obj/item/clothing/shoes/magboots/elite //For the Syndicate Strike Team/SolGov/Tactical Teams
+/// For the Syndicate Strike Team/SolGov/Tactical Teams
+/obj/item/clothing/shoes/magboots/elite
 	name = "elite tactical magboots"
 	desc = "Advanced magboots used by strike teams across the system. Allows for tactical insertion into low-gravity areas of operation."
 	icon_state = "elitemag0"
@@ -143,7 +144,8 @@
 		to_chat(user, "<span class='notice'>You switch on the waddle dampeners!</span>")
 		enabled_waddle = FALSE
 
-/obj/item/clothing/shoes/magboots/wizard //bundled with the wiz hardsuit
+/// bundled with the wiz hardsuit
+/obj/item/clothing/shoes/magboots/wizard
 	name = "boots of gripping"
 	desc = "These magical boots, once activated, will stay gripped to any surface without slowing you down."
 	icon_state = "wizmag0"

code/modules/clothing/shoes/misc_shoes.dm

@@ -3,7 +3,8 @@
 	icon_state = "mime"
 	item_color = "mime"
 
-/obj/item/clothing/shoes/combat //basic syndicate combat boots for nuke ops and mob corpses
+/// basic syndicate combat boots for nuke ops and mob corpses
+/obj/item/clothing/shoes/combat
 	name = "combat boots"
 	desc = "High speed, low drag combat boots."
 	w_class = WEIGHT_CLASS_NORMAL
@@ -14,7 +15,8 @@
 	strip_delay = 70
 	resistance_flags = NONE
 
-/obj/item/clothing/shoes/combat/swat //overpowered gimmick boots
+/// overpowered gimmick boots
+/obj/item/clothing/shoes/combat/swat
 	name = "\improper SWAT shoes"
 	desc = "High speed, no drag combat boots."
 	permeability_coefficient = 0.01
@@ -57,7 +59,8 @@
 	desc = "A pair of purple rubber boots, designed to prevent slipping on wet surfaces while also drying them."
 	icon_state = "galoshes_dry"
 
-/obj/item/clothing/shoes/galoshes/dry/lightweight /// for red janitor ert.
+/// / for red janitor ert.
+/obj/item/clothing/shoes/galoshes/dry/lightweight
 	name = "lightweight absorbent galoshes"
 	desc = "A pair of expensive looking lightweight rubber boots, designed to prevent slipping on wet surfaces while also drying them."
 	slowdown = NONE

code/modules/clothing/suits/armor_suits.dm

@@ -648,7 +648,8 @@
 		disable(rand(2, 5))
 		return TRUE
 
-/obj/item/clothing/suit/armor/reactive/random //Spawner for random reactive armor
+/// Spawner for random reactive armor
+/obj/item/clothing/suit/armor/reactive/random
 	name = "Random Reactive Armor"
 
 /obj/item/clothing/suit/armor/reactive/random/Initialize(mapload)

code/modules/clothing/suits/misc_suits.dm

@@ -325,7 +325,8 @@
 	flags = BLOCKHAIR
 	flags_inv = HIDEEARS
 
-/obj/item/clothing/suit/hooded/bee_costume // It's Hip!
+/// It's Hip!
+/obj/item/clothing/suit/hooded/bee_costume
 	name = "bee costume"
 	desc = "Bee the true Queen!"
 	icon_state = "bee"
@@ -344,14 +345,16 @@
 	flags_inv = HIDEEARS
 	sprite_sheets = list("Vox" = 'icons/mob/clothing/species/vox/head.dmi')
 
-/obj/item/clothing/suit/bloated_human	//OH MY GOD WHAT HAVE YOU DONE!?!?!?
+/// OH MY GOD WHAT HAVE YOU DONE!?!?!?
+/obj/item/clothing/suit/bloated_human
 	name = "bloated human suit"
 	desc = "A horribly bloated suit made from human skins."
 	icon_state = "lingspacesuit"
 	item_state = "lingspacesuit"
 	body_parts_covered = UPPER_TORSO|LOWER_TORSO|ARMS
 
-/obj/item/clothing/suit/draculacoat // Bleh!
+/// Bleh!
+/obj/item/clothing/suit/draculacoat
 	name = "transylvanian coat"
 	desc = "<i>What is a spessman? A miserable little pile of secrets.</i>"
 	icon_state = "draculacoat"

code/modules/clothing/under/accessories/accessory.dm

@@ -133,7 +133,8 @@
 	icon_state = "horribletie"
 	item_color = "horribletie"
 
-/obj/item/clothing/accessory/waistcoat // No overlay
+/// No overlay
+/obj/item/clothing/accessory/waistcoat
 	name = "waistcoat"
 	desc = "For some classy, murderous fun."
 	icon_state = "waistcoat"
@@ -311,7 +312,8 @@
 	desc = "An award issued by the Quartermaster to supply staff dedicated to being effective."
 	channel = "Supply"
 
-/obj/item/clothing/accessory/medal/recruiter // Prize for the NT Recruiter emagged arcade
+/// Prize for the NT Recruiter emagged arcade
+/obj/item/clothing/accessory/medal/recruiter
 	name = "nanotrasen recruiter medal"
 	desc = "A prize for those who completed the company's most difficult training, use it to earn the respect of everyone in human resources."
 
@@ -363,7 +365,8 @@
 	desc = "An award which represents magnificant contributions to the HRD-MDE project in the form of analysing Bubblegum, and the related blood space."
 	channel = null
 
-/obj/item/clothing/accessory/medal/gold/heroism/hardmode_full //Kill every hardmode boss. In a shift. Good luck.
+/// Kill every hardmode boss. In a shift. Good luck.
+/obj/item/clothing/accessory/medal/gold/heroism/hardmode_full
 	name = "medal of incredible dedication"
 	desc = "An extremely rare golden medal awarded only by CentComm. This medal was issued for miners who went above and beyond for the HRD-MDE project. Engraved on it is the phrase <i>'mori quam foedari'...</i>"
 	channel = null
@@ -489,7 +492,8 @@
 //SCARVES//
 ///////////
 
-/obj/item/clothing/accessory/scarf // No overlay
+/// No overlay
+/obj/item/clothing/accessory/scarf
 	name = "scarf"
 	desc = "A stylish scarf. The perfect winter accessory for those with a keen fashion sense, and those who just can't handle a cold breeze on their necks."
 	dog_fashion = /datum/dog_fashion/head

code/modules/clothing/under/color.dm

@@ -125,7 +125,8 @@
 	item_state = "p_suit"
 	item_color = "purple"
 
-/obj/item/clothing/under/color/purple/sensor	//for jani ert
+/// for jani ert
+/obj/item/clothing/under/color/purple/sensor
 	sensor_mode = SENSOR_COORDS
 	random_sensor = FALSE
 

code/modules/clothing/under/costumes.dm

@@ -138,7 +138,8 @@
 	item_state = "psyamp"
 	item_color = "psyamp"
 
-/obj/item/clothing/under/psysuit //Don't modify the path, used by a fluff item
+/// Don't modify the path, used by a fluff item
+/obj/item/clothing/under/psysuit
 	name = "dark undersuit"
 	desc = "A thick, layered grey undersuit lined with power cables. Feels a little like wearing an electrical storm."
 	icon_state = "psysuit"

code/modules/clothing/under/jobs/medical_jumpsuits.dm

@@ -149,7 +149,8 @@
 	item_state = "psychturtle"
 	item_color = "psychturtle"
 
-/obj/item/clothing/under/rank/medical/gown //Seems like it should be here for organisational purposes
+/// Seems like it should be here for organisational purposes
+/obj/item/clothing/under/rank/medical/gown
 	name = "medical gown"
 	desc = "a flimsy examination gown, the back ties never close."
 	icon_state = "medicalgown"