Clarify that loseContext also frees WebGL resources (#42894)

* Clarify that loseContext also frees WebGL resources

* Merge paragraphs

* Update restoreContext too

---------

Co-authored-by: Joshua Chen <sidachen2003@gmail.com>

Author: badwriter123

files/en-us/web/api/webgl_lose_context/losecontext/index.md

@@ -8,12 +8,9 @@ browser-compat: api.WEBGL_lose_context.loseContext
 
 {{APIRef("WebGL")}}
 
-The **WEBGL_lose_context.loseContext()** method is part of the [WebGL API](/en-US/docs/Web/API/WebGL_API) and allows you to simulate losing
-the context of a {{domxref("WebGLRenderingContext")}} context.
+The **`loseContext()`** method of the `WEBGL_lose_context` extension is part of the [WebGL API](/en-US/docs/Web/API/WebGL_API) and allows you to simulate losing the context of a {{domxref("WebGLRenderingContext")}}.
 
-It triggers the steps described in the WebGL specification for handling context lost.
-The context will remain lost until {{domxref("WEBGL_lose_context.restoreContext()")}} is
-called.
+It triggers the [steps described in the WebGL specification](https://registry.khronos.org/webgl/specs/latest/1.0/#5.15.2) for handling context lost. The context will remain lost until {{domxref("WEBGL_lose_context.restoreContext()")}} is called. It also destroys the underlying graphics context and all graphics resources. This is the recommended mechanism for applications to programmatically halt their use of the WebGL API.
 
 ## Syntax
 
@@ -31,9 +28,7 @@ None ({{jsxref("undefined")}}).
 
 ## Examples
 
-With this method, you can simulate the
-[`webglcontextlost`](/en-US/docs/Web/API/HTMLCanvasElement/webglcontextlost_event)
-event:
+With this method, you can simulate the [`webglcontextlost`](/en-US/docs/Web/API/HTMLCanvasElement/webglcontextlost_event) event:
 
 ```js
 const canvas = document.getElementById("canvas");
@@ -59,7 +54,4 @@ gl.getExtension("WEBGL_lose_context").loseContext();
 ## See also
 
 - {{domxref("WebGLRenderingContext.isContextLost()")}}
-- Events:
-  [`webglcontextlost`](/en-US/docs/Web/API/HTMLCanvasElement/webglcontextlost_event),
-  [`webglcontextrestored`](/en-US/docs/Web/API/HTMLCanvasElement/webglcontextrestored_event),
-  [`webglcontextcreationerror`](/en-US/docs/Web/API/HTMLCanvasElement/webglcontextcreationerror_event)
+- Events: [`webglcontextlost`](/en-US/docs/Web/API/HTMLCanvasElement/webglcontextlost_event), [`webglcontextrestored`](/en-US/docs/Web/API/HTMLCanvasElement/webglcontextrestored_event), [`webglcontextcreationerror`](/en-US/docs/Web/API/HTMLCanvasElement/webglcontextcreationerror_event)

files/en-us/web/api/webgl_lose_context/restorecontext/index.md

@@ -8,8 +8,9 @@ browser-compat: api.WEBGL_lose_context.restoreContext
 
 {{APIRef("WebGL")}}
 
-The **WEBGL_lose_context.restoreContext()** method is part of the [WebGL API](/en-US/docs/Web/API/WebGL_API) and allows you to simulate
-restoring the context of a {{domxref("WebGLRenderingContext")}} object.
+The **`restoreContext()`** method of the `WEBGL_lose_context` extension is part of the [WebGL API](/en-US/docs/Web/API/WebGL_API) and allows you to simulate restoring the context of a {{domxref("WebGLRenderingContext")}}.
+
+It triggers the [steps described in the WebGL specification](https://registry.khronos.org/webgl/specs/latest/1.0/#5.15.3) for handling context restored. The context is not usable until the {{domxref("HTMLCanvasElement.webglcontextrestored_event", "webglcontextrestored")}} event is fired.
 
 ## Syntax
 
@@ -34,9 +35,7 @@ Browsers may not report WebGL errors by default. WebGL's error reporting works b
 
 ## Examples
 
-With this method, you can simulate the
-[`webglcontextrestored`](/en-US/docs/Web/API/HTMLCanvasElement/webglcontextrestored_event)
-event:
+With this method, you can simulate the [`webglcontextrestored`](/en-US/docs/Web/API/HTMLCanvasElement/webglcontextrestored_event) event:
 
 ```js
 const canvas = document.getElementById("canvas");
@@ -60,7 +59,4 @@ gl.getExtension("WEBGL_lose_context").restoreContext();
 ## See also
 
 - {{domxref("WebGLRenderingContext.isContextLost()")}}
-- Events:
-  [`webglcontextlost`](/en-US/docs/Web/API/HTMLCanvasElement/webglcontextlost_event),
-  [`webglcontextrestored`](/en-US/docs/Web/API/HTMLCanvasElement/webglcontextrestored_event),
-  [`webglcontextcreationerror`](/en-US/docs/Web/API/HTMLCanvasElement/webglcontextcreationerror_event)
+- Events: [`webglcontextlost`](/en-US/docs/Web/API/HTMLCanvasElement/webglcontextlost_event), [`webglcontextrestored`](/en-US/docs/Web/API/HTMLCanvasElement/webglcontextrestored_event), [`webglcontextcreationerror`](/en-US/docs/Web/API/HTMLCanvasElement/webglcontextcreationerror_event)