updated appearach of example sections based on alainbryden suggestion

src/ScriptEditor/NetscriptDefinitions.d.ts

@@ -3710,17 +3710,24 @@ interface Stanek {
  * @remarks
  * <b>Basic ns1 usage example:</b>
  * ```ts
- * property.methodName;
+ *  // Basic ns functions can be used directly
+ *  methodName();
+ *  // Some related functions are gathered within a common namespace
+ *  property.methodName()
  * ```
  * {@link https://bitburner.readthedocs.io/en/latest/netscript/netscript1.html| ns1 in-game docs}
  * <hr>
  * <b>Basic ns2 usage example:</b>
  * ```ts
  * export async function main(ns) {
- *   ns.property.methodName;
+ *  // Basic ns functions can be accessed on the ns object
+ *  ns.methodName;
+ *  // Some related functions are gathered under a sub-property of the ns object
+ *  ns.property.methodName
  * }
  * ```
  * {@link https://bitburner.readthedocs.io/en/latest/netscript/netscriptjs.html| ns2 in-game docs}
+ * <hr>
  */
 export interface NS extends Singularity {
   /**