snippets: update comments and add comment-section

Update comments to use ;; --------- style, more visually appealing

Add comment-section with start & end line comments

Author: practicalli-johnny

README.md

@@ -15,6 +15,7 @@ Clone the repository to the user level configuration location for Clojure LSP, e
 ### Docs / comments
 * `comment-heading` - describe purpose of the namespace
 * `comment-separator` - logically separate code sections, helps identify opportunities to refactor to other name spaces
+* `comment-section` - logically separate large code sections with start and end line comments
 
 ### Repl Driven Development
 * `rich-comment` - comment block

config.edn

@@ -11,20 +11,30 @@
  ;; Snippets with $current-form only work when used in front of a form
  ;; otherwise the snippet will not appear in the auto-complete drop-down
  ;; Custom Snippets
+ ;; --------------------------------------------------
+ ;; LSP snippets
+ ;; https://clojure-lsp.io/features/#snippets
+
+ ;; Locally defined snippets
  :additional-snippets
- [;; Documentation
-  {:name "comment-heading"
+ [{:name "comment-heading"
    :detail "Comment Header"
    :snippet
-   ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-    ;; ${1:Namespace summary title}
+   ";; --------------------------------------------------
+    ;; ${1:Heading summary title}
     ;;
-    ;; ${2:Brief description}\n;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;\n\n$0"}
+    ;; ${2:Brief description}\n;; --------------------------------------------------\n\n$0"}
 
   {:name "comment-separator"
    :detail "Comment Separator"
    :snippet
-   ";; ${1:Namespace summary title}\n;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;\n\n$0"}
+   ";; --------------------------------------------------\n;; ${1:Section title}\n\n$0"}
+
+  {:name "comment-section"
+   :detail "Comment Section"
+   :snippet
+   ";; --------------------------------------------------\n;; ${1:Section title}\n\n$0\n\n
+    ;; End of $1\n;; --------------------------------------------------\n\n"}
 
   {:name "rich-comment"
    :detail "Create rich comment"