Full functional specification in: https://github.com/konveyor/enhancements/blob/d7420ebe74c5b883ba811cc9f03fa9911ed011e2/enhancements/assets-generation/README.md#platform-awareness-1

Stages of content journey

The content journey for the Platform Awareness feature in the Migration Toolkit for Applications (MTA) is designed to guide users through their experience, from initial discovery to advanced usage. Here’s a detailed outline based on the specified stages:

1. Discover

Objective: Introduce users to the Platform Awareness feature and its significance in the migration process.

• • Content Types:

• • • Overview Articles: Provide a high-level introduction to Platform Awareness, explaining its purpose and benefits in the context of application migration.
    • Key Concepts Document: Define essential terms and concepts related to platform awareness, such as compatibility, requirements, and constraints of the target environment.
    • Use Case Scenarios: Highlight scenarios where platform awareness can enhance migration planning and execution.
  • Key Messages:

• • • What is Platform Awareness, and why is it important for successful migrations?
    • Overview of how understanding the target platform can impact migration strategies.

2. Learn

Objective: Educate users on the features and functionalities of the Platform Awareness tool.

• • Content Types:

• • • User Guides: Detailed documentation on how to use the Platform Awareness feature, including step-by-step instructions for assessing platform compatibility.
    • Feature Descriptions: In-depth explanations of specific functionalities, such as analyzing platform requirements and identifying gaps.
    • Best Practices: Recommendations for effectively using the Platform Awareness feature to maximize its benefits.
  • Key Messages:

• • • How to set up and configure the Platform Awareness tool.
    • Understanding the output of platform assessments and how to interpret the results.
    • Common pitfalls to avoid when evaluating platform compatibility.

3. Try

Objective: Encourage users to experiment with the Platform Awareness feature through practical applications.

• • Content Types:

• • • Tutorials: Step-by-step tutorials guiding users through the process of assessing platform awareness in a test environment.
    • Sample Assessments: Pre-configured examples that users can download and explore to understand the functionality of platform awareness.
  • Key Messages:

• • • Experience the capabilities of Platform Awareness firsthand.
    • Practical applications of platform assessments for migration planning.
    • Encourage users to explore different configurations and outputs.

4. Adopt

Objective: Support users in integrating the Platform Awareness feature into their migration workflows.

• • Content Types:

• • • Implementation Guides: Comprehensive documentation on how to incorporate Platform Awareness into existing migration processes.
    • Case Studies: Real-world examples of organizations that have successfully adopted the Platform Awareness feature, highlighting challenges and solutions.
    • FAQs and Troubleshooting Guides: Address common questions and issues that arise during the adoption process.
  • Key Messages:

• • • Steps to successfully integrate Platform Awareness into your migration strategy.
    • Success stories that illustrate the value of using platform awareness for migration planning.
    • Troubleshooting tips for common challenges faced during implementation.

5. Expand

Objective: Encourage users to explore advanced features and additional resources related to Platform Awareness.

• • Content Types:

• • • Advanced User Guides: Documentation on more complex functionalities and features of the Platform Awareness tool.
    • Webinars and Workshops: Information on upcoming training sessions focused on advanced platform assessment techniques and best practices.
    • Resource Libraries: Curated lists of additional documentation, tools, and community resources related to platform awareness.
  • Key Messages:

• • • Unlock the full potential of Platform Awareness with advanced techniques.
    • Continuous learning opportunities to stay updated with the latest features and enhancements.
    • Engage with the community for knowledge sharing and support.

What is the main user goal aka job to be done?

1. As a cloud architect, I want to assess the compatibility of my applications with different cloud platforms so that I can make informed decisions about migration strategies.

1. As a DevOps engineer, I want to automate the deployment of applications across multiple platforms so that I can reduce manual effort and minimize errors during the migration process.

1. As a project manager, I want to track the progress of application migrations in real-time so that I can ensure that the project stays on schedule and within budget.

1. As a software developer, I want to receive recommendations for platform-specific optimizations so that I can enhance application performance and take full advantage of cloud features.