diff --git a/mods/ITEMS/mcl_core/nodes.lua b/mods/ITEMS/mcl_core/nodes.lua
index ec591ff56e..4eb14fb026 100644
--- a/mods/ITEMS/mcl_core/nodes.lua
+++ b/mods/ITEMS/mcl_core/nodes.lua
@@ -1559,7 +1559,12 @@ minetest.register_node("mcl_core:water_flowing", {
 minetest.register_node("mcl_core:water_source", {
 	description = "Still Water",
 	_doc_items_entry_name = "Water",
-	_doc_items_longdesc = "Water is abundant in oceans and may also appear in small quantities in underground water pockets. You can swim easily in water, but you need to catch your breath from time to time. Water will turn nearby lava into obsidian or stone.",
+	_doc_items_longdesc =
+[[Water is abundant in oceans and also appears in a few springs in the ground. You can swim easily in water, but you need to catch your breath from time to time.
+Water interacts with lava in various ways:
+• When water is directly above or horizontally next to still lava, the lava turns into obsidian.
+• When flowing water touches flowing lava either from above or horizontally, the lava turns into cobblestone.
+• When water is directly below lava, the water turns into stone.]],
 	_doc_items_hidden = false,
 	inventory_image = minetest.inventorycube("default_water.png"),
 	drawtype = "liquid",
@@ -1643,7 +1648,13 @@ minetest.register_node("mcl_core:lava_flowing", {
 minetest.register_node("mcl_core:lava_source", {
 	description = "Still Lava",
 	_doc_items_entry_name = "Lava",
-	_doc_items_longdesc = "Lava is found deep underground and rather dangerous. Don't touch it, it will hurt you a lot and once you're in, it is hard to get out. When a lava source meets water, it turns into obsidian. Flowing lava turns into stone instead. Lava source blocks set fire to air blocks above when they're next to a flammable block.",
+	_doc_items_longdesc =
+[[Lava is hot and rather dangerous. Don't touch it, it will hurt you a lot and it is hard to get out.
+Still lava sets fire to a couple of air blocks above when they're next to a flammable block.
+Lava interacts with water various ways:
+• When still lava is directly below or horizontally next to water, the lava turns into obsidian.
+• When flowing water touches flowing lava either from above or horizontally, the lava turns into cobblestone.
+• When lava is directly above water, the water turns into stone.]],
 	inventory_image = minetest.inventorycube("default_lava.png"),
 	drawtype = "liquid",
 	tiles = {