[gjs: 5/6] doc: Advise against modifying prototype of String

[Philip Chimento <pchimento src gnome org>]

commit 5bbfb173bde45e03a7eaee8c7df6ae572e552d3f
Author: Philip Chimento <philip chimento gmail com>
Date:   Sat Aug 6 12:06:09 2022 -0700

    doc: Advise against modifying prototype of String
    
    Format.format() was originally intended to be put on String.prototype, but
    that is widely considered bad practice now.

 doc/Modules.md | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)
---
diff --git a/doc/Modules.md b/doc/Modules.md
index 5b822b6fb..384922716 100644
--- a/doc/Modules.md
+++ b/doc/Modules.md
@@ -109,16 +109,22 @@ let baz = Math.PI;
 // Using native template literals (Output: Pi to 2 decimal points: 3.14)
 `${foo} to ${bar*2} decimal points: ${baz.toFixed(bar*2)}`
 
-// Applying format() to the string prototype
 const Format = imports.format;
-String.prototype.format = Format.format;
 
 // Using format() (Output: Pi to 2 decimal points: 3.14)
+Format.format.call("%s to %d decimal points: %.2f", foo, bar * 2, baz);
+
+// Applying format() to the string prototype (this is the old way, but
+// is often considered bad practice now, especially in GNOME Shell
+// extensions where other extensions might overwrite it.
+// Consider not doing this!)
+String.prototype.format = Format.format;
 "%s to %d decimal points: %.2f".format(foo, bar*2, baz);
 
 // Using format() with Gettext
-_("%d:%d").format(11, 59);
-Gettext.ngettext("I have %d apple", "I have %d apples", num).format(num);
+Format.format.call(_("%d:%d"), 11, 59);
+Format.format.call(
+    Gettext.ngettext("I have %d apple", "I have %d apples", num), num);
 
 ```