fix(documentation): Improved and updated README with detailed usage instructions

package.json

@@ -2,7 +2,7 @@
   "name": "@push.rocks/smartfm",
   "version": "2.1.0",
   "private": false,
-  "description": "frontmatter done right",
+  "description": "A Node.js module for handling and processing frontmatter in markdown and text files, leveraging the gray-matter library for parsing and stringifying YAML or JSON formatted frontmatter.",
   "exports": {
     ".": "./dist/index.js"
   },
@@ -17,7 +17,19 @@
     "url": "git+https://code.foss.global/push.rocks/smartfm.git"
   },
   "keywords": [
-    "frontmatter"
+    "frontmatter",
+    "markdown",
+    "text files",
+    "YAML",
+    "JSON",
+    "stringify",
+    "parse",
+    "commented sections",
+    "static site generator",
+    "CMS",
+    "content metadata",
+    "metadata management",
+    "gray-matter"
   ],
   "author": "Lossless GmbH",
   "license": "MIT",
@@ -47,4 +59,4 @@
     "npmextra.json",
     "readme.md"
   ]
-}
+}