docs: updated based on feedback

Author: ike-kottlowski

src/Core/MailTemplates/Mjml/README.md

@@ -1,12 +1,12 @@
 # MJML email templating
 
-This directory contains MJML templates for emails. MJML is a markup language designed to reduce the pain of coding responsive email templates. There are DRY features within the library which will improve code quality.
+This directory contains MJML templates for emails. MJML is a markup language designed to reduce the pain of coding responsive email templates. Component based development features in MJML improve code quality and reusability.
 
 MJML stands for MailJet Markup Language.
 
 ## Implementation considerations
 
-These `MJML` templates are compiled into HTML which will then be further consumed by our HandleBars mail service. We can continue to use this service to assign values from our View Models. This leverages the existing infrastructure. It also means we can continue to use the double brace (`{{}}`) syntax within MJML since Handlebars can be used to assign values to those `{{variables}}`.
+These `MJML` templates are compiled into HTML which will then be further consumed by our Handlebars mail service. We can continue to use this service to assign values from our View Models. This leverages the existing infrastructure. It also means we can continue to use the double brace (`{{}}`) syntax within MJML since Handlebars can be used to assign values to those `{{variables}}`.
 
 There is no change on how we interact with our view models.
 
@@ -21,19 +21,19 @@ There is no change to how we create the `txt.hbs`. MJML does not impact how we c
 ```shell
 npm ci
 
-# Build *.html, output is the ./out directory
+# Build *.html to ./out directory
 npm run build
 
 # To build on changes to *.mjml and *.js files, new files will not be tracked, you will need to run again
 npm run build:watch
 
-# Build *.html.hbs once, output is the ./out directory
+# Build *.html.hbs to ./out directory
 npm run build:hbs
 
-# Build *.html.hbs in a minified ./out directory
+# Build minified *.html.hbs to ./out directory
 npm run build:minify
 
-# apply prettier formatting to all files
+# apply prettier formatting
 npm run prettier
 ```
 
@@ -45,21 +45,24 @@ When using MJML templating you can use the above [commands](#building-mjml-files
 
 Not all MJML tags have the same attributes, it is highly recommended to review the documentation on the official MJML website to understand the usages of each of the tags.
 
-### Possible process
+### Recommended development
 
-#### Initial email development might look something like:
+#### Mjml email template development
 
-1. create `cool-email.mjml`
+1. create `cool-email.mjml` in appropriate team directory
 2. run `npm run build:watch`
 3. view compiled `HTML` output in a web browser
-4. iterate -> while `build:watch`'ing you should be able to refresh the browser page after the mjml re-compile to see the changes
+4. iterate -> while `build:watch`'ing you should be able to refresh the browser page after the mjml/js re-compile to see the changes
 
 #### Testing with `IMailService`
 
-After the email is developed from the [initial step](#initial-email-development-might-look-something-like) you'll probably want to make sure the email `{{variables}}` are populated properly by running it through an `IMailService`.
+After the email is developed from the [initial step](#mjml-email-template-development) make sure the email `{{variables}}` are populated properly by running it through an `IMailService` implementation.
 
 1. run `npm run build:minify`
 2. copy built `*.html.hbs` files from the build directory to a location the mail service can consume them
+3. run code that will send the email
+
+The minified `html.hbs` artifacts are deliverables and must be placed into the correct `src/Core/MailTemplates/Handlebars/` directories in order to be used by `IMailService` implementations.
 
 ### Custom tags
 

src/Core/MailTemplates/README.md

@@ -9,8 +9,9 @@ We use MJML to generate the HTML that our mail services use to send emails to us
 These are the compiled HTML email templates that serve as the foundation for all HTML emails sent by the Bitwarden platform. They are generated from MJML source files and enhanced with Handlebars templating capabilities.
 
 ### Generation Process
-- **Source**: Built from `*.mjml` files in the `./mjml` directory using the MJML build pipeline
-- **Build Tool**: Generated via PowerShell build script (`build.ps1`) or npm scripts
+- **Source**: Built from `*.mjml` files in the `./mjml` directory.
+  - The MJML source acts as a toolkit for developers to generate HTML. It is the developers responsibility to generate the HTML and then ensure it is accessible to `IMailService` implementations.
+- **Build Tool**: Generated via node build scripts: `npm run build`.
 - **Output**: Cross-client compatible HTML with embedded CSS for maximum email client support
 - **Template Engine**: Enhanced with Handlebars syntax for dynamic content injection