api documentation loads very slowly

[kcoleman-marklogic]

I've found that the API documentation generated by jsdoc loads very slowly. This is because it is trying to load a remote google font and is timing out. Every page takes > 20s to load. This is a known, open issue with ink-docstrap, but it doesn't sound like one that's going to get solved, so we need to fix it.

It should be possible for us to customize the template not to import any fonts. Along the way, I can change the font family to match what we use on pubs, and perhaps brand the colors a bit.

Then, we just have to integrate the custom template into the gulp task that generates the jsdoc.

[kcoleman-marklogic]

I have created a custom template. Erik and I are corresponding about how to integrate it into the project.

[kcoleman-marklogic]

Further template customization was necessary to make the output acceptable to the online documentation application. (Embedded javascript = evil).

We must check the customized template into node-client-api and reference it in the doc gulp task. The checkin will be in Erik's hands, so I am reassigning to him for now.

Erik, I can supply the files and the gulpfile.js changes to you when you're ready to proceed. After you add this stuff to the project, you can reassign to me for testing. Feel free to change the milestone to ea3 if you need extra time.

[ehennum]

checked in under ./etc with modified gulpfile; so much better than before