update and tidy up functions, add missing docblocks

assets/styles/core.scss

@@ -1,3 +1,10 @@
+/**
+*
+* Core styles should contain all the core, important styling to improve
+* peformance and first impression of the site on load.
+*
+**/
+
 @import 'config/variables';
 @import 'config/mixins';
 

assets/styles/styles.scss

@@ -1,3 +1,9 @@
+/**
+*
+* Styles, containing "less" important layouts, components and pages
+*
+**/
+
 @import 'config/variables';
 @import 'config/mixins';