chore(docs): added further comments for clarity (#144)

Author: mfranzke

source/css/_db-ui-core.variables.scss

@@ -1,3 +1,7 @@
+/* *****
+	This file summarizes the general variables relevant for using DB UI Core with SCSS.
+***** */
+
 // Define the path for both image and font folders
 $icons-path: "../../icons/" !default;
 $images-path: "../../images/" !default;

source/css/_fonts.general.scss

@@ -1,3 +1,7 @@
+/* *****
+	SCSS placeholder for general font declarations
+***** */
+
 @import "db-ui-core.variables";
 
 %general-fonts {

source/css/db-ui-core.general.scss

@@ -1,3 +1,7 @@
+/* *****
+	This is mainly meant to get included within scoped components like e.g. within StencilJS Custom Components / DB UI Elements
+***** */
+
 @import "db-ui-core.variables";
 @import "@csstools/normalize.css/normalize";
 @import "../_patterns/00-base/init";

source/css/db-ui-core.vars.scss

@@ -1,3 +1,9 @@
+/* *****
+	This file is meant to get included globally on a page with a standard set of variables and font references,
+	if you're using only partials – either Web Components out of DB UI Elements or the partial CSS generated out
+	of DB UI Core for each element and component.
+***** */
+
 // Define the path for both image and font folders
 $icons-path: "../icons/" !default;
 $images-path: "../images/" !default;
@@ -12,6 +18,7 @@ $fonts-path: "../fonts/" !default;
 @import "../_patterns/00-base/icons/icons.font-faces";
 
 :root {
+	// Overwriting the referenced SVG icons as this is going to get inlined and the path would be relative to the pages URL instead of the CSS, which would break
 	--db-ic-search-24: url(#{$icons-path}functional/images/action/db_ic_search_24.svg);
 	--db-ic-expand-more-20: url(#{$icons-path}functional/images/navigation/db_ic_expand_more_20.svg);
 }