Reads a samples directory, extracting samples between [START]/[STOP] tags, allowing these samples to be placed in JSDoc comments, like so:

/*
  * @example <caption>include:samples/document-snippets/cluster.js</caption>
  * region_tag:bigtable_delete_cluster
  */

1. npm i jsdoc-region-tag.

2. add the plugin to your .jsdoc.js.

   module.exports = {
     plugins: [
       'jsdoc-region-tag'
     ]
   }

The environment varaible SAMPLES_DIRECTORY can be set, to set a samples directory other than ./samples.

Apache-2.0