Utilise documentation systems for CSS and JS

[khawkins98]

We have a lot of functionality that is hard to/impractical to document in the EBI Style lab. For these cases using traditional documentation systems would be superior.

An initial proof of concept has been integrated:

• Uses npm documentation.js and kss: https://github.com/ebiwd/EBI-Framework/blob/v1.3/package.json#L41
• Outputs to
  • css: http://wwwdev.ebi.ac.uk/web_guidelines/EBI-Framework/v1.3/css/styleguide/section-components.html
  • js: https://github.com/ebiwd/EBI-Framework/blob/v1.3/js/documenation.md#table-of-contents

[khawkins98]

This will likely be an ongoing effort as we release various update to v1.3 and begin work on v1.4.

As a todo, we need to write documentation on how to write documentation!

[khawkins98]

This has been addressed in VF 2.0