Mini Content Journey

• Who is your target persona?
    C-Suite IT
    Automation Architect
    Enterprise Architect Leader

• What stage of the user journey are you targeting?
    Configuration and customization stage

• Why is this content important?
    This content is crucial as it addresses a specific need of enterprise environments with strict SMTP policies. It allows users to customize the SMTP EHLO/HELO hostname in RHACS Email Notifier, ensuring compatibility with their mail relay servers. This feature is already supported in other Red Hat products like Alertmanager and Postfix, and its inclusion in RHACS will enhance its usability and value in enterprise settings.

• What high level steps does the user need to take to accomplish the goal?
    1. Access the Email Notifier configuration in RHACS.
    2. Locate the new configuration field for the SMTP EHLO Name.
    3. Enter the desired hostname.
    4. Save the changes.

• What is the general sentiment of users towards this goal?
    Users, particularly those in C-Suite IT, Automation Architect, Enterprise Architect Leader, and IT Operations Leader roles, express a strong interest in this feature. They value the ability to customize the SMTP EHLO/HELO hostname to ensure compatibility with their enterprise mail relay servers, which often enforce strict SMTP policies. Additionally, there is a clear demand from users for this feature, as evidenced by the creation of the related issue (ROX-30654) and subsequent documentation task (ROX-30849).

• What pain points are the user likely to encounter when accomplishing this goal?
    Users may encounter difficulties in locating the new configuration field, understanding its purpose, and correctly entering the desired hostname. They might also face challenges in ensuring that the new configuration aligns with their specific enterprise policies and requirements.

• What other feedback do users have around this goal?
    There is a clear demand from users for this feature, as evidenced by the creation of the related issue (ROX-30654) and subsequent documentation task (ROX-30849). Users appreciate the potential for RHACS to match the level of customization offered by other Red Hat products like Alertmanager and Postfix.

• Are there any additional opportunities you can also implement for the user when documenting this goal?
    Yes, additional opportunities could include providing clear visual aids (like screenshots) to guide users to the correct configuration field, offering examples of suitable hostnames, and detailing potential implications of different configurations on email delivery and security. Furthermore, highlighting the interoperability with other Red Hat products like Alertmanager and Postfix can be beneficial.

• People:
    SME: Agil Antony
    QE: Not specified in the context
    Release Note: Yes

• Documentation Outline:

Module Title: Configuring the EHLO/HELO Hostname for SMTP Notifiers in RHACS
  Overview of content required:
  1. Introduction to the feature and its benefits.
  2. Explanation of the problem it solves (strict SMTP policies).
  3. Step-by-step guide on how to configure the SMTP EHLO Name.
  4. Additional considerations and best practices.

Module Title: Prerequisites
  Overview of content required:
  1. System requirements for configuring the SMTP EHLO Name.
  2. Necessary permissions or roles.

Module Title: Procedure
  Prerequisites: Completed prerequisites module.
  Outline of steps:
  1. Access the Email Notifier configuration in RHACS.
  2. Locate the new configuration field for the SMTP EHLO Name.
  3. Enter the desired hostname.
  4. Save the changes.

Module Title: Reference
  Overview of content required:
  1. Detailed explanation of the SMTP EHLO/HELO handshake.
  2. Implications of different hostname configurations.
  3. Troubleshooting common issues.
  4. Interoperability with other Red Hat products like Alertmanager and Postfix.