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/mining/equipment/marker_beacons.dm

@@ -27,10 +27,12 @@ GLOBAL_LIST_INIT(marker_beacon_colors, list(
 	max_amount = 100
 	var/picked_color = "random"
 
-/obj/item/stack/marker_beacon/ten //miners start with 10 of these
+/// miners start with 10 of these
+/obj/item/stack/marker_beacon/ten
 	amount = 10
 
-/obj/item/stack/marker_beacon/thirty //and they're bought in stacks of 1, 10, or 30
+/// and they're bought in stacks of 1, 10, or 30
+/obj/item/stack/marker_beacon/thirty
 	amount = 30
 
 /obj/item/stack/marker_beacon/Initialize(mapload)

code/modules/mining/equipment/mining_tools.dm

@@ -105,7 +105,8 @@
 	origin_tech = "materials=6;powerstorage=4;engineering=4"
 	toolspeed = 0.2
 
-/obj/item/pickaxe/drill/cyborg/diamond //This is the BORG version!
+/// This is the BORG version!
+/obj/item/pickaxe/drill/cyborg/diamond
 	name = "diamond-tipped cyborg mining drill" //To inherit the NODROP flag, and easier to change borg specific drill mechanics.
 	icon_state = "diamonddrill"
 	toolspeed = 0.2

code/modules/mining/equipment/wormhole_jaunter.dm

@@ -168,7 +168,8 @@
 /obj/effect/portal/advanced/getaway
 	one_use = TRUE
 
-/obj/effect/temp_visual/getaway_flare // Because the original contractor flare is not a temp visual, for some reason.
+/// Because the original contractor flare is not a temp visual, for some reason.
+/obj/effect/temp_visual/getaway_flare
 	name = "contractor extraction flare"
 	icon = 'icons/obj/lighting.dmi'
 	icon_state = "flare-contractor-on"

code/modules/mining/lavaland/ash_flora.dm

@@ -75,7 +75,8 @@
 	else
 		..()
 
-/obj/structure/flora/ash/tall_shroom //exists only so that the spawning check doesn't allow these spawning near other things
+/// exists only so that the spawning check doesn't allow these spawning near other things
+/obj/structure/flora/ash/tall_shroom
 	regrowth_time_low = 4200
 
 /obj/structure/flora/ash/leaf_shroom
@@ -197,7 +198,8 @@
 	pixel_x = rand(-4, 4)
 	pixel_y = rand(-4, 4)
 
-/obj/item/food/snacks/grown/ash_flora/shavings //for actual crafting
+/// for actual crafting
+/obj/item/food/snacks/grown/ash_flora/shavings
 
 /obj/item/food/snacks/grown/ash_flora/mushroom_leaf
 	name = "mushroom leaf"

code/modules/mining/lavaland/loot/colossus_loot.dm

@@ -85,7 +85,8 @@
 	new random_crystal(loc)
 	return INITIALIZE_HINT_QDEL
 
-/obj/machinery/anomalous_crystal/theme_warp //Warps the area you're in to look like a new one
+/// Warps the area you're in to look like a new one
+/obj/machinery/anomalous_crystal/theme_warp
 	activation_method = "touch"
 	cooldown_add = 200
 	var/terrain_theme = "winter"
@@ -159,7 +160,8 @@
 					continue
 			affected_targets += A
 
-/obj/machinery/anomalous_crystal/emitter //Generates a projectile when interacted with
+/// Generates a projectile when interacted with
+/obj/machinery/anomalous_crystal/emitter
 	activation_method = "touch"
 	cooldown_add = 50
 	var/generated_projectile = /obj/item/projectile/beam/emitter
@@ -188,7 +190,8 @@
 				P.xo = 0
 		P.fire()
 
-/obj/machinery/anomalous_crystal/dark_reprise //Revives anyone nearby, but turns them into shadowpeople and renders them uncloneable, so the crystal is your only hope of getting up again if you go down.
+/// Revives anyone nearby, but turns them into shadowpeople and renders them uncloneable, so the crystal is your only hope of getting up again if you go down.
+/obj/machinery/anomalous_crystal/dark_reprise
 	activation_method = "touch"
 	activation_sound = 'sound/hallucinations/growl1.ogg'
 
@@ -206,7 +209,8 @@
 					ADD_TRAIT(H, TRAIT_BADDNA, MAGIC_TRAIT) //Free revives, but significantly limits your options for reviving except via the crystal
 					H.grab_ghost(force = TRUE)
 
-/obj/machinery/anomalous_crystal/helpers //Lets ghost spawn as helpful creatures that can only heal people slightly. Incredibly fragile and they can't converse with humans
+/// Lets ghost spawn as helpful creatures that can only heal people slightly. Incredibly fragile and they can't converse with humans
+/obj/machinery/anomalous_crystal/helpers
 	activation_method = "touch"
 	var/ready_to_deploy = 0
 
@@ -299,7 +303,8 @@
 /mob/living/simple_animal/hostile/lightgeist/ghost()
 	qdel(src)
 
-/obj/machinery/anomalous_crystal/possessor //Allows you to bodyjack small animals, then exit them at your leisure, but you can only do this once per activation. Because they blow up. Also, if the bodyjacked animal dies, SO DO YOU.
+/// Allows you to bodyjack small animals, then exit them at your leisure, but you can only do this once per activation. Because they blow up. Also, if the bodyjacked animal dies, SO DO YOU.
+/obj/machinery/anomalous_crystal/possessor
 	activation_method = "touch"
 
 /obj/machinery/anomalous_crystal/possessor/ActivationReaction(mob/user, method)