docs: add globSource and urlSource utility examples

Author: Alan Shaw

SPEC/FILES.md

@@ -156,6 +156,58 @@ Prints out objects like:
 
 Now [ipfs.io/ipfs/Qm...WW](https://ipfs.io/ipfs/QmNz1UBzpdd4HfZ3qir3aPiRdX5a93XwTuDNyXRc6PKhWW) returns the "ABC" string.
 
+**Importing files from the file system:**
+
+Both js-ipfs and js-ipfs-http-client export a utility to make importing files from the file system easier (Note: it not available in the browser).
+
+```js
+const IPFS = require('ipfs')
+const { globSource } = IPFS
+
+const ipfs = await IPFS.create()
+
+for await (const file of ipfs.add(globSource('./docs', { recursive: true }))) {
+  console.log(file)
+}
+
+/*
+{
+  path: 'docs/assets/anchor.js',
+  cid: CID('QmVHxRocoWgUChLEvfEyDuuD6qJ4PhdDL2dTLcpUy3dSC2'),
+  size: 15347
+}
+{
+  path: 'docs/assets/bass-addons.css',
+  hash: CID('QmPiLWKd6yseMWDTgHegb8T7wVS7zWGYgyvfj7dGNt2viQ'),
+  size: 232
+}
+...
+*/
+```
+
+**Importing a file from a URL:**
+
+Both js-ipfs and js-ipfs-http-client export a utility to make importing a file from a URL easier.
+
+```js
+const IPFS = require('ipfs')
+const { globSource } = IPFS
+
+const ipfs = await IPFS.create()
+
+for await (const file of ipfs.add(urlSource('https://ipfs.io/images/ipfs-logo.svg'))) {
+  console.log(file)
+}
+
+/*
+{
+  path: 'ipfs-logo.svg',
+  cid: CID('QmTqZhR6f7jzdhLgPArDPnsbZpvvgxzCZycXK7ywkLxSyU'),
+  size: 3243
+}
+*/
+```
+
 A great source of [examples][] can be found in the tests for this API.
 
 #### `cat`