diff --git a/test/validation/link-validator.test.js b/test/validation/link-validator.test.js new file mode 100644 index 0000000..60914d8 --- /dev/null +++ b/test/validation/link-validator.test.js @@ -0,0 +1,71 @@ +import fs from 'fs'; +import { expect } from '@esm-bundle/chai'; +import { + getLinksLists, + compareLinkLists, + LINKS_MATCH, + LINKS_DO_NOT_MATCH, + LENGTHS_DO_NOT_MATCH, + validateMigratedPageLinks, +} from '../../validation/link-validator.js'; +import { getMdast } from '../../bulk-update/document-manager/document-manager.js'; +import { ExcelReporter } from '../../bulk-update/index.js'; + +const { pathname } = new URL('.', import.meta.url); + +describe('Validator', () => { + const sourceMd = fs.readFileSync(`${pathname}mocks/adobe-experience-manager-source.md`, 'utf-8'); + const updatedMd = fs.readFileSync(`${pathname}mocks/adobe-experience-manager-updated.md`, 'utf-8'); + const mismatchMd = fs.readFileSync(`${pathname}mocks/adobe-experience-manager-updated-mismatched.md`, 'utf-8'); + const shuffledMd = fs.readFileSync(`${pathname}mocks/adobe-experience-manager-shuffled.md`, 'utf-8'); + + it('Returns "all links match" based on link match', async () => { + const sourceMdast = await getMdast(sourceMd); + const updatedMdast = await getMdast(updatedMd); + const { sourceLinks, updatedLinks } = await getLinksLists(sourceMdast, updatedMdast); + + const message = compareLinkLists(sourceLinks, updatedLinks); + expect(message[1]).to.equal(LINKS_MATCH); + }); + + it('Returns "link mismatch mapping" based on link mismatch', async () => { + const sourceMdast = await getMdast(sourceMd); + const mismatchedMdast = await getMdast(mismatchMd); + const { sourceLinks, updatedLinks } = await getLinksLists(sourceMdast, mismatchedMdast); + + const message = compareLinkLists(sourceLinks, updatedLinks); + const mismatchHash = message[3].log['hashMatch-5']; + const mismatchPath = message[3].log['pathMatch-6']; + const mismatchSearch = message[3].log['searchMatch-7']; + const mismatchHost = message[3].log['hostMatch-8']; + const mismatchText = message[3].log['textMatch-9']; + expect(message[1]).to.equal(LINKS_DO_NOT_MATCH); + expect(mismatchHash).to.be.false; + expect(mismatchPath).to.be.false; + expect(mismatchSearch).to.be.false; + expect(mismatchHost).to.be.false; + expect(mismatchText).to.be.false; + }); + + it('Returns "source and updated list do not have the same length" when the files have different link numbers', async () => { + const sourceMdast = await getMdast(sourceMd); + const shuffledMdast = await getMdast(shuffledMd); + const { sourceLinks, updatedLinks } = await getLinksLists(sourceMdast, shuffledMdast); + + const message = compareLinkLists(sourceLinks, updatedLinks); + expect(message[2]).to.equal(LENGTHS_DO_NOT_MATCH); + }); + + it('valiates the migration', async () => { + const pathToListShort = `${pathname}/mocks/list.json`; + const mdPath = `${pathname}/mocks/md-mocks`; + const dateString = ExcelReporter.getDateString(); + const myReporter = new ExcelReporter(`${pathname}output/validation-${dateString}.xlsx`, false); + + await validateMigratedPageLinks(pathToListShort, mdPath, myReporter); + const report = myReporter.getReport(); + expect(Object.keys(report.logs).length).to.equal(2); + expect(report.logs['Compare Links'].length).to.equal(3); + expect(report.logs['Deep Compare Links'].length).to.equal(2); + }); +}); diff --git a/test/validation/mocks/adobe-experience-manager-shuffled.md b/test/validation/mocks/adobe-experience-manager-shuffled.md new file mode 100644 index 0000000..269130a --- /dev/null +++ b/test/validation/mocks/adobe-experience-manager-shuffled.md @@ -0,0 +1,235 @@ +# Adobe Experience Manager — what it is and how it works + +![Adobe Experience Manager — what it is and how it works][image0] + +Trying to keep track of all your digital content and assets — let alone organizing and using them effectively to reach your customers and earn their trust — is daunting, to say the least. + +As a business owner, you need a solution for managing all of your digital content. Maybe you’ve heard that Adobe Experience Manager can simplify digital content management, but you aren’t sure if it’s time to make the switch. + +Adobe Experience Manager combines digital asset management and content management into a unified solution for delivering timely, relevant, and personal experiences. This article will break down what Experience Manager is all about and show you why it’s the best option for comprehensive digital content management. + +This post will discuss: + +- [What Adobe Experience Manager is](https://business.adobe.com/products/workfront/main.html#what-is-adobe-experience-manager) +- [How Experience Manager works](https://experienceleague.adobe.com/docs/experience-manager-65/administering/integration/target.html#how-experience-manager-works) +- [Key features of Experience Manager](https://business.adobe.com/blog/basics/complete-guide-to-content-hubs#key-features-of-adobe-experience-manager) +- [Benefits of Experience Manager](https://www.adobe.com/creativecloud.html#benefits-of-adobe-experience-manager) +- [Integrating Experience Manager with other products](https://experienceleague.adobe.com/docs/experience-manager-65/administering/integration/adobeanalytics.html#integrating-experience-manager-with-other-products) +- [Getting started](https://main--business-website--adobe.hlx.page/blog/basics/adobe-experience-manager#getting-started) + +## What is Adobe Experience Manager? + +[Adobe Experience Manager](https://main--business-website--adobe.hlx.page/blog/basics/adobe-experience-manager) is a software solution that’s equal part content management system (CMS) and digital asset management (DAM) system. + +Experience Manager helps companies regain control over their digital content, which is often spread across numerous sites, channels, and apps — by providing much-needed structure for content management. This reduces the complexity of content management to save businesses time. + +[According to a 2021 Forrester report](https://business.adobe.com/resources/why-adobe-commerce-better-cloud.html), Experience Manager is the most robust CMS on the market. More than [128,000 websites](https://main--business-website--adobe.hlx.page/blog/basics/adobe-experience-manager) rely on the agile setup of Experience Manager to manage their content. + +Unlike other solutions, Experience Manager allows you to manage and sync data and content across different internal systems as well as customer-facing channels. This amounts to a more comprehensive, unified customer experience that saves your team time while improving your public image. + +## How Experience Manager works + +Brands rely on Experience Manager because it encompasses several functions that work together to create a streamlined, simplified experience. Experience Manager allows you to manage [content fragments, create responsive web designs,](https://business.adobe.com/products/experience-manager/adobe-experience-manager.html) and more. + +Experience Manager works by combining these six time-saving solutions into a single platform. + +![Experience Manager combines six solutions][image1] + +### Content management system — Experience Manager Sites + +[Adobe Experience Manager Sites](https://main--business-website--adobe.hlx.page/blog/basics/adobe-experience-manager) is a marketer- and developer-friendly content management system. With Experience Manager Sites, you can quickly build a website using templates and ready-to-use components. Developers can also customize the site with minimal code. + +Experience Manager Sites lets developers and marketers publish content simultaneously and seamlessly on nearly any platform or channel. Plus, its generative artificial intelligence tools make it easy to change the tone of voice, add content variations, and make universal changes to all content. + +Experience Manager Sites is perfect for creating personalized experiences for different customer segments. For example, if you’re a software company that caters to both businesses and individuals, you can create separate landing pages for both audiences in just a few clicks. + +Experience Manager Sites is fast, easy to use, and secure, so it’s a popular option for both resource-minded small businesses and busy enterprise teams. + +### Digital asset management — Experience Manager Assets + +[Adobe Experience Manager Assets](https://business.adobe.com/products/experience-manager/adobe-experience-manager.html) is a [digital asset management system](https://business.adobe.com/products/target/adobe-target.html#:~:text=A%20digital%20asset%20management%20\(DAM,Read%20the%20report%20now%20%3E) which is a cloud-based system that stores and organizes all of your digital files. Instead of trying to locate files between your employees’ separate computers and accounts, a DAM makes it easy for your team to access assets like images, videos, and even 3D models in a shared environment. + +For example, you can store a social media post template on the DAM and share it with your team. When you train your team to pull from this template, you’ll ensure that all social media posts follow your branding guidelines. Experience Manager Assets also tracks changes, so if anyone adjusts the templates, you can see it in the revision history. + +Experience Manager Assets lives on Adobe’s cloud, so you don’t have to worry about storing large files locally. Plus, Experience Manager Assets is fast, scalable, and integrates with other Adobe software to streamline your workflow. + +### Digital enrollment and forms + +Experience Manager includes digital enrollment and forms, which helps you build a smooth digital enrollment and onboarding journey from start to finish. This feature removes the need for paper, helping your business easily embrace digital transformation — all while speeding up your workflows. + +Digital enrollment and forms makes it easy to build digital forms, collect e-signatures, and kick off onboarding with simple automations. For example, sales teams can build onboarding forms for new clients instead of sending dozens of emails back and forth. Once the client completes onboarding and signs a contract, the system will automatically send the client a message about onboarding. This helps your sales team save time and gives clients a better experience. + +Whether you want to create forms for internal or external use, digital enrollment and forms are easy to use across multiple platforms. + +### Digital Screens + +[Digital Screens](https://main--business-website--adobe.hlx.page/blog/basics/adobe-experience-manager) is a digital signage solution that gives marketers the ability to create and manage digital signage for stores and venues. With this feature, you can communicate with digital signs displayed in store, which makes Digital Screens ideal for omnichannel businesses. + +You can create and update the signage easily, as well as coordinate sign messages in multiple locations from one dashboard. For example, if your company has a brick-and-mortar presence, you can use Digital Screens to add smart product recommendations to in-store displays — and even customize the product suggestions based on each store’s clientele. This elevates the in-store experience, educates shoppers, and saves time for in-store staff. + +In a world where customers expect a consistent experience both online and offline, Digital Screens gives you the power to sync your marketing in the physical world with your online efforts. + +### Digital Guides + +Digital Guides is software for creating product documentation and supporting content. Digital Guides is a component content management system (CCMS), which isn’t to be confused with a CMS. This tool structures content by organizing it into components that you can easily change out as needed. + +For example, if you change a product feature, you need to ensure that all of your help documentation addresses that change so customers have a consistent experience. Without a CCMS, you would have to make this change manually. But Digital Guides makes it easy to make these changes at scale by easily swapping out content components. + +Product features change over time, and that can cause disruptions for both your employees and customers. Digital Guides helps you easily format and link your user guides to help everyone have a better experience. + +### Adobe Learning Manager + +[Adobe Learning Manager](https://business.adobe.com/products/experience-manager/adobe-experience-manager.html?gclid=Cj0KCQjwyLGjBhDKARIsAFRNgW8hdS4piiL5gSg22gPNFOXQoXQiDU8KXsykfRi3dgZTvNrFk7_jjLkaAo_pEALw_wcB\&sdid=SEMBRALMNA\&ef_id=Cj0KCQjwyLGjBhDKARIsAFRNgW8hdS4piiL5gSg22gPNFOXQoXQiDU8KXsykfRi3dgZTvNrFk7_jjLkaAo_pEALw_wcB:G:s\&s_kwcid=AL!3085!3!613272989017!e!!g!!adobe%20learning%20manager) is software that allows you to create your own training programs. You can use it for customer education, sales and partner training, franchise and in-store training, employee reskilling, and compliance training. + +Normally, it takes a lot of time to create personalized training for your business. But Learning Manager allows you to create both internal and external training with 86,000 ready-made courses from an existing content marketplace. It also comes with engaging features like gamification, leaderboards, and social learning. + +For example, you can use Learning Manager to train new managers in your organization on leadership best practices. Learning Manager also gives you the ability to engage customers with external-facing training, which can increase engagement and sales. + +![More than 128,000 websites rely on Adobe Experience Manager][image2] + +## Key features of Adobe Experience Manager + +Experience Manager comes packed with powerful features to streamline your workflows while creating an all-around better customer experience. + +### Project dashboard + +Experience Manager comes with a sleek, centralized dashboard that gives you a high-level view of all projects. Every project is a resource group represented as a tile for easy access. + +For example, all of your training materials might be under one tile in the dashboard. This helps you quickly access your different projects, as well as add tasks, assets, or external links for each project. + +### Out-of-the-box technology + +- Experience Manager is a plug-and-play platform that you can use with zero code. The user-friendly setup makes it easy for anyone to use, thanks to its: +- What you see is what you get (WYSIWYG) editor +- Editable templates and core components, such as headers and footers, with adjustable styling +- Responsive layout +- Add-ons + +While coding isn’t necessary to use Experience Manager, developers can still add custom code to personalize the platform even more. But you don’t need to be a development savant to use this platform effectively because of its: + +- **Low-code setup.** The low-code options in Experience Manager allow you to customize templates with very little coding knowledge. +- **Example code.** Experience Manager provides example code to show you what’s possible in the platform. +- **Open source.** Experience Manager is built on open-source Java. Developers can use open-source React and Angular Core components too. This means there’s a large developer community available to answer any questions you have about customizing Experience Manager. + +### Cloud service + +As a cloud platform, Experience Manager is very scalable. All of your users will always have access to the latest features. You don’t have to worry about the time or expense of managing your own IT resources since Adobe manages all upgrades for you. + +Adobe also takes cloud security seriously. Experience Manager has robust security features, including access management, encryption, and multifactor authentication. + +### Visual media conversion + +Resizing images and videos for every channel is time-consuming, especially if you have a lot of assets. The visual media conversion feature of Experience Manager allows you to convert files into different sizes and formats in bulk. + +For example, if you created a social media graphic for Twitter, Instagram, and Facebook, all of these channels have different image sizing and formatting limits. Visual media conversion allows you to quickly convert these images into the right sizes with just a few clicks. + +### Omnichannel content delivery + +The Experience Manager headless CMS facilitates omnichannel delivery. You can manage multiple websites — even if they’re in different languages — to create a full omnichannel experience for customers around the globe. Experience Manager allows you to share content on every channel, including mobile and Internet of Things (IoT) devices, to deliver a consistent experience across multiple touchpoints. + ++---------------------------------------------------------------------------------------------------------------+ +| quote (borders, align left) | ++-------------------------------------------------------x-------------------------------------------------------+ +| Adobe Experience Manager combines digital asset management and content management into a unified solution for | +| delivering timely, relevant, and personal experiences. | ++---------------------------------------------------------------------------------------------------------------+ + +## Benefits of Adobe Experience Manager + +Instead of using a piecemeal approach for your business, Experience Manager gives you multiple solutions rolled into one convenient platform. More businesses are investing in Experience Manager because of its: + +1. **Easy-to-use CMS.** You don’t need any special experience or training to manage content in Experience Manager. The intuitive platform allows non-technical users to easily manage content across multiple properties. +2. **Automated workflows.** Experience Manager automates tasks to keep the ball rolling for your teams. Use the artificial intelligence (AI) features to tag, crop, and distribute assets in record time. +3. **Improved search for digital assets.** Stop wondering where your images and videos are. Experience Manager pulls all of your digital assets into one place, making it easy to find and adapt content as needed. +4. **Personalized content.** Easily create content variations on each channel to create hyper-specific experiences for all of your target personas. +5. **Ability to target customers wherever they are.** Experience Manager gives you the ability to deliver targeted experiences, regardless of where customers choose to engage with you. +6. **Better task management.** Content management requires a lot of tasks, which is why Experience Manager streamlines digital asset management to-dos. Easily add tasks to each project in your dashboard to stay on top of your workload. +7. **Easy integration.** Keep everything on the same platform. Whether you’re using third-party analytics or [Adobe Marketing Cloud](https://business.adobe.com/products/experience-manager/sites/omnichannel-experiences.html), Experience Manager easily integrates with other tools. +8. **Flexibility and scalability.** Boost engagement by creating different content variations for all of your personas in just a few clicks. +9. **Add-on functionality.** If you need more specific functionality, Experience Manager add-ons are available through third parties and the Magento marketplace. + +## Integrating Experience Manager with other products + +While Experience Manager comes with a lot of features out of the box, organizations can also integrate Experience Manager with additional services to get even more value out of the platform. Try integrating it with other products, such as: + +- **Ecommerce software.** Experience Manager integrates with major ecommerce solutions to streamline content and asset management. It integrates with [Adobe Commerce](https://main--business-website--adobe.hlx.page/blog/basics/adobe-experience-manager?gclid=Cj0KCQjwyLGjBhDKARIsAFRNgW_wRjl5l9mxwrEE--I0ZezqiIUA015NpgoUNokweL_ihcNqTco-RbAaAnwDEALw_wcB\&sdid=49F59KRV\&mv=search\&edtamo=true\&ef_id=Cj0KCQjwyLGjBhDKARIsAFRNgW_wRjl5l9mxwrEE--I0ZezqiIUA015NpgoUNokweL_ihcNqTco-RbAaAnwDEALw_wcB:G:s\&s_kwcid=AL!3085!3!645909280032!e!!g!!adobe%20commerce!16001298912!136314953927\&mv=search\&edtamo=true\&gad=1), BigCommerce, Shopify, WooCommerce, and more. +- **[Adobe Workfront](https://business.adobe.com/in/index/topics/digital-asset-management.html).** Manage your team’s tasks and workflows by [integrating Workfront with Assets](https://business.adobe.com/products/experience-manager/sites/aem-sites.html). This integration makes it easy to approve content, deliver assets, and publish content using the power of automation. +- **[Adobe Creative Cloud](https://business.adobe.com/products/experience-manager/sites/digital-signage.html).** Whether you’re brainstorming content ideas or need creative variations for different platforms, [integrating Creative Cloud with Experience Manager](https://trends.builtwith.com/cms/Adobe-Experience-Manager?lang=en#_blank) makes it possible to process assets at scale. Configure files in Experience Manager to effortlessly bulk process files with Lightroom Presets, Image Masks, and more. +- **[Adobe Target](https://business.adobe.com/products/experience-manager/assets/aem-assets.html).** [Integrating Adobe Target with Experience Manager](https://business.adobe.com/blog/basics/content-management?lang=en#_blank) makes it possible to personalize web content to each of your target personas. Target can show you which customers to focus on so you can message them more effectively with Experience Manager Sites, Screens, or Forms. +- **[Adobe Analytics Cloud](https://business.adobe.com/products/workfront/aem-integration.html).** Get a more complete view of your web activity by [integrating Analytics Cloud with Experience Manager.](https://business.adobe.com/products/marketing-cloud/main.html?lang=en#_blank) Track the performance of your Adobe Forms and continue optimizing your content to encourage even more engagement at scale. + +## Getting started + +Adobe Experience Manager is an all-in-one suite that simplifies content and asset management at scale. It integrates with multiple solutions to streamline workflows, automate tasks, and provide a better customer experience. + +When you’re ready to get started, learn a little more, or try it for yourself, [get a demo of Adobe Experience Manager](https://experienceleague.adobe.com/docs/experience-manager-cloud-service/content/assets/manage/cc-api-integration.html). + +[Experience Manager](https://business.adobe.com/blog/the-latest/digital-experiences-with-adobe-experience-manager-sites) combines digital asset management and content management into a unified solution for delivering timely, relevant, and personal experiences. It helps you source, adapt, automate, and deliver one-on-one digital experiences across web, IoT, and more — at any scale — powered by the latest AI. As a cloud service, Experience Manager is always on and up to date so you can make the most of your content and stay ahead of rising customer expectations. + +**Watch the overview video to learn more.** + ++-----------------------------------------------------------------------------------------x-----------------------------------------------------------------------------------------+ +| Recommended articles | ++-----------------------------------------------------------------------------------------x-----------------------------------------------------------------------------------------+ +| [https://business.adobe.com/blog/basics/content-management](https://www.forrester.com/blogs/agile-cms-moves-the-market-beyond-headless-forresters-just-released-wave-evaluation/) | +| | +| [https://business.adobe.com/blog/basics/complete-guide-to-content-hubs](https://business.adobe.com/products/learning-manager/adobe-learning-manager.html) | +| | +| [https://business.adobe.com/blog/the-latest/digital-experiences-with-adobe-experience-manager-sites](https://business.adobe.com/products/analytics/analytics-cloud.html) | ++-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + ++----------------------------------------x-----------------------------------------+ +| Metadata | ++-----------x------------+----------------------------x----------------------------+ +| Title | Adobe Experience Manager — what it is and how it works | ++-----------x------------+----------------------------x----------------------------+ +| | Adobe Experience Manager is a software solution that’s | +| Description | equal parts content management system (CMS) and digital | +| | asset management (DAM) system. | ++-----------x------------+----------------------------x----------------------------+ +| | \ | +| Author | Adobe Experience Cloud Team | ++-----------x------------+----------------------------x----------------------------+ +| | \ | +| Publication Date | 06-27-2023 | ++-----------x------------+----------------------------x----------------------------+ +| Category | Basics | ++-----------x------------+----------------------------x----------------------------+ +| | Content Management, Customer Success, Marketing | +| Tags | Automation, Personalization | ++-----------x------------+----------------------------x----------------------------+ +| Industry | N/A | ++-----------x------------+----------------------------x----------------------------+ +| Customer Journey Stage | Discover | ++-----------x------------+----------------------------x----------------------------+ +| Product | Adobe Experience Manager | ++-----------x------------+----------------------------x----------------------------+ +| Audience | Content Marketer, Digital Marketer, Marketing Executive | ++-----------x------------+----------------------------x----------------------------+ +| SEO-Article | Tier 2 | ++------------------------+---------------------------------------------------------+ + ++-------------------------------------------------------------------------------------------------+ +| Card Metadata | ++------------------+------------------------------------------------------------------------------+ +| Title | Adobe Experience Manager — what it is and how it works | ++------------------+------------------------------------------------------------------------------+ +| CardDate | 2023-06-27 | ++------------------+------------------------------------------------------------------------------+ +| CardImage | ![Adobe Experience Manager — what it is and how it works card image][image0] | ++------------------+------------------------------------------------------------------------------+ +| CardImageAltText | Adobe Experience Manager — what it is and how it works card image | ++------------------+------------------------------------------------------------------------------+ +| CardDescription | Adobe Experience Manager is a software solution that’s equal parts content | +| | management system (CMS) and digital asset management (DAM) system. | ++------------------+------------------------------------------------------------------------------+ +| primaryTag | caas:content-type/blog | ++------------------+------------------------------------------------------------------------------+ +| Tags | caas:content-type/blog, caas:cta/read-article | ++------------------+------------------------------------------------------------------------------+ + +[image0]: https://main--bacom-blog--adobecom.hlx.page/media_1d7b0ffdb7bb5b4d1de9a5680fc2fbe671c5f689f.png#width=2000&height=1000 + +[image1]: https://main--bacom-blog--adobecom.hlx.page/media_134a6d035fb68239a3fde3b37cd436b74ccbb5a09.png#width=2000&height=1000 + +[image2]: https://main--bacom-blog--adobecom.hlx.page/media_150d892bf5de0c8d1e6a814e3147dda11d4365ca6.png#width=2000&height=220 diff --git a/test/validation/mocks/adobe-experience-manager-source.md b/test/validation/mocks/adobe-experience-manager-source.md new file mode 100644 index 0000000..4dd494f --- /dev/null +++ b/test/validation/mocks/adobe-experience-manager-source.md @@ -0,0 +1,235 @@ +# Adobe Experience Manager — what it is and how it works + +![Adobe Experience Manager — what it is and how it works][image0] + +Trying to keep track of all your digital content and assets — let alone organizing and using them effectively to reach your customers and earn their trust — is daunting, to say the least. + +As a business owner, you need a solution for managing all of your digital content. Maybe you’ve heard that Adobe Experience Manager can simplify digital content management, but you aren’t sure if it’s time to make the switch. + +Adobe Experience Manager combines digital asset management and content management into a unified solution for delivering timely, relevant, and personal experiences. This article will break down what Experience Manager is all about and show you why it’s the best option for comprehensive digital content management. + +This post will discuss: + +- [What Adobe Experience Manager is](https://main--business-website--adobe.hlx.page/blog/basics/adobe-experience-manager#what-is-adobe-experience-manager) +- [How Experience Manager works](https://main--business-website--adobe.hlx.page/blog/basics/adobe-experience-manager#how-experience-manager-works) +- [Key features of Experience Manager](https://main--business-website--adobe.hlx.page/blog/basics/adobe-experience-manager#key-features-of-adobe-experience-manager) +- [Benefits of Experience Manager](https://main--business-website--adobe.hlx.page/blog/basics/adobe-experience-manager#benefits-of-adobe-experience-manager) +- [Integrating Experience Manager with other products](https://main--business-website--adobe.hlx.page/blog/basics/adobe-experience-manager#integrating-experience-manager-with-other-products) +- [Getting started](https://main--business-website--adobe.hlx.page/blog/basics/adobe-experience-manager#getting-started) + +## What is Adobe Experience Manager? + +[Adobe Experience Manager](https://business.adobe.com/products/experience-manager/adobe-experience-manager.html) is a software solution that’s equal part content management system (CMS) and digital asset management (DAM) system. + +Experience Manager helps companies regain control over their digital content, which is often spread across numerous sites, channels, and apps — by providing much-needed structure for content management. This reduces the complexity of content management to save businesses time. + +[According to a 2021 Forrester report](https://www.forrester.com/blogs/agile-cms-moves-the-market-beyond-headless-forresters-just-released-wave-evaluation/), Experience Manager is the most robust CMS on the market. More than [128,000 websites](https://trends.builtwith.com/cms/Adobe-Experience-Manager) rely on the agile setup of Experience Manager to manage their content. + +Unlike other solutions, Experience Manager allows you to manage and sync data and content across different internal systems as well as customer-facing channels. This amounts to a more comprehensive, unified customer experience that saves your team time while improving your public image. + +## How Experience Manager works + +Brands rely on Experience Manager because it encompasses several functions that work together to create a streamlined, simplified experience. Experience Manager allows you to manage [content fragments, create responsive web designs,](https://business.adobe.com/products/experience-manager/sites/omnichannel-experiences.html) and more. + +Experience Manager works by combining these six time-saving solutions into a single platform. + +![Experience Manager combines six solutions][image1] + +### Content management system — Experience Manager Sites + +[Adobe Experience Manager Sites](https://business.adobe.com/products/experience-manager/sites/aem-sites.html) is a marketer- and developer-friendly content management system. With Experience Manager Sites, you can quickly build a website using templates and ready-to-use components. Developers can also customize the site with minimal code. + +Experience Manager Sites lets developers and marketers publish content simultaneously and seamlessly on nearly any platform or channel. Plus, its generative artificial intelligence tools make it easy to change the tone of voice, add content variations, and make universal changes to all content. + +Experience Manager Sites is perfect for creating personalized experiences for different customer segments. For example, if you’re a software company that caters to both businesses and individuals, you can create separate landing pages for both audiences in just a few clicks. + +Experience Manager Sites is fast, easy to use, and secure, so it’s a popular option for both resource-minded small businesses and busy enterprise teams. + +### Digital asset management — Experience Manager Assets + +[Adobe Experience Manager Assets](https://business.adobe.com/products/experience-manager/assets/aem-assets.html) is a [digital asset management system](https://business.adobe.com/in/index/topics/digital-asset-management.html#:~:text=A%20digital%20asset%20management%20\(DAM,Read%20the%20report%20now%20%3E) which is a cloud-based system that stores and organizes all of your digital files. Instead of trying to locate files between your employees’ separate computers and accounts, a DAM makes it easy for your team to access assets like images, videos, and even 3D models in a shared environment. + +For example, you can store a social media post template on the DAM and share it with your team. When you train your team to pull from this template, you’ll ensure that all social media posts follow your branding guidelines. Experience Manager Assets also tracks changes, so if anyone adjusts the templates, you can see it in the revision history. + +Experience Manager Assets lives on Adobe’s cloud, so you don’t have to worry about storing large files locally. Plus, Experience Manager Assets is fast, scalable, and integrates with other Adobe software to streamline your workflow. + +### Digital enrollment and forms + +Experience Manager includes digital enrollment and forms, which helps you build a smooth digital enrollment and onboarding journey from start to finish. This feature removes the need for paper, helping your business easily embrace digital transformation — all while speeding up your workflows. + +Digital enrollment and forms makes it easy to build digital forms, collect e-signatures, and kick off onboarding with simple automations. For example, sales teams can build onboarding forms for new clients instead of sending dozens of emails back and forth. Once the client completes onboarding and signs a contract, the system will automatically send the client a message about onboarding. This helps your sales team save time and gives clients a better experience. + +Whether you want to create forms for internal or external use, digital enrollment and forms are easy to use across multiple platforms. + +### Digital Screens + +[Digital Screens](https://business.adobe.com/products/experience-manager/sites/digital-signage.html) is a digital signage solution that gives marketers the ability to create and manage digital signage for stores and venues. With this feature, you can communicate with digital signs displayed in store, which makes Digital Screens ideal for omnichannel businesses. + +You can create and update the signage easily, as well as coordinate sign messages in multiple locations from one dashboard. For example, if your company has a brick-and-mortar presence, you can use Digital Screens to add smart product recommendations to in-store displays — and even customize the product suggestions based on each store’s clientele. This elevates the in-store experience, educates shoppers, and saves time for in-store staff. + +In a world where customers expect a consistent experience both online and offline, Digital Screens gives you the power to sync your marketing in the physical world with your online efforts. + +### Digital Guides + +Digital Guides is software for creating product documentation and supporting content. Digital Guides is a component content management system (CCMS), which isn’t to be confused with a CMS. This tool structures content by organizing it into components that you can easily change out as needed. + +For example, if you change a product feature, you need to ensure that all of your help documentation addresses that change so customers have a consistent experience. Without a CCMS, you would have to make this change manually. But Digital Guides makes it easy to make these changes at scale by easily swapping out content components. + +Product features change over time, and that can cause disruptions for both your employees and customers. Digital Guides helps you easily format and link your user guides to help everyone have a better experience. + +### Adobe Learning Manager + +[Adobe Learning Manager](https://business.adobe.com/products/learning-manager/adobe-learning-manager.html?gclid=Cj0KCQjwyLGjBhDKARIsAFRNgW8hdS4piiL5gSg22gPNFOXQoXQiDU8KXsykfRi3dgZTvNrFk7_jjLkaAo_pEALw_wcB\&sdid=SEMBRALMNA\&ef_id=Cj0KCQjwyLGjBhDKARIsAFRNgW8hdS4piiL5gSg22gPNFOXQoXQiDU8KXsykfRi3dgZTvNrFk7_jjLkaAo_pEALw_wcB:G:s\&s_kwcid=AL!3085!3!613272989017!e!!g!!adobe%20learning%20manager) is software that allows you to create your own training programs. You can use it for customer education, sales and partner training, franchise and in-store training, employee reskilling, and compliance training. + +Normally, it takes a lot of time to create personalized training for your business. But Learning Manager allows you to create both internal and external training with 86,000 ready-made courses from an existing content marketplace. It also comes with engaging features like gamification, leaderboards, and social learning. + +For example, you can use Learning Manager to train new managers in your organization on leadership best practices. Learning Manager also gives you the ability to engage customers with external-facing training, which can increase engagement and sales. + +![More than 128,000 websites rely on Adobe Experience Manager][image2] + +## Key features of Adobe Experience Manager + +Experience Manager comes packed with powerful features to streamline your workflows while creating an all-around better customer experience. + +### Project dashboard + +Experience Manager comes with a sleek, centralized dashboard that gives you a high-level view of all projects. Every project is a resource group represented as a tile for easy access. + +For example, all of your training materials might be under one tile in the dashboard. This helps you quickly access your different projects, as well as add tasks, assets, or external links for each project. + +### Out-of-the-box technology + +- Experience Manager is a plug-and-play platform that you can use with zero code. The user-friendly setup makes it easy for anyone to use, thanks to its: +- What you see is what you get (WYSIWYG) editor +- Editable templates and core components, such as headers and footers, with adjustable styling +- Responsive layout +- Add-ons + +While coding isn’t necessary to use Experience Manager, developers can still add custom code to personalize the platform even more. But you don’t need to be a development savant to use this platform effectively because of its: + +- **Low-code setup.** The low-code options in Experience Manager allow you to customize templates with very little coding knowledge. +- **Example code.** Experience Manager provides example code to show you what’s possible in the platform. +- **Open source.** Experience Manager is built on open-source Java. Developers can use open-source React and Angular Core components too. This means there’s a large developer community available to answer any questions you have about customizing Experience Manager. + +### Cloud service + +As a cloud platform, Experience Manager is very scalable. All of your users will always have access to the latest features. You don’t have to worry about the time or expense of managing your own IT resources since Adobe manages all upgrades for you. + +Adobe also takes cloud security seriously. Experience Manager has robust security features, including access management, encryption, and multifactor authentication. + +### Visual media conversion + +Resizing images and videos for every channel is time-consuming, especially if you have a lot of assets. The visual media conversion feature of Experience Manager allows you to convert files into different sizes and formats in bulk. + +For example, if you created a social media graphic for Twitter, Instagram, and Facebook, all of these channels have different image sizing and formatting limits. Visual media conversion allows you to quickly convert these images into the right sizes with just a few clicks. + +### Omnichannel content delivery + +The Experience Manager headless CMS facilitates omnichannel delivery. You can manage multiple websites — even if they’re in different languages — to create a full omnichannel experience for customers around the globe. Experience Manager allows you to share content on every channel, including mobile and Internet of Things (IoT) devices, to deliver a consistent experience across multiple touchpoints. + ++---------------------------------------------------------------------------------------------------------------+ +| quote (borders, align left) | ++-------------------------------------------------------x-------------------------------------------------------+ +| Adobe Experience Manager combines digital asset management and content management into a unified solution for | +| delivering timely, relevant, and personal experiences. | ++---------------------------------------------------------------------------------------------------------------+ + +## Benefits of Adobe Experience Manager + +Instead of using a piecemeal approach for your business, Experience Manager gives you multiple solutions rolled into one convenient platform. More businesses are investing in Experience Manager because of its: + +1. **Easy-to-use CMS.** You don’t need any special experience or training to manage content in Experience Manager. The intuitive platform allows non-technical users to easily manage content across multiple properties. +2. **Automated workflows.** Experience Manager automates tasks to keep the ball rolling for your teams. Use the artificial intelligence (AI) features to tag, crop, and distribute assets in record time. +3. **Improved search for digital assets.** Stop wondering where your images and videos are. Experience Manager pulls all of your digital assets into one place, making it easy to find and adapt content as needed. +4. **Personalized content.** Easily create content variations on each channel to create hyper-specific experiences for all of your target personas. +5. **Ability to target customers wherever they are.** Experience Manager gives you the ability to deliver targeted experiences, regardless of where customers choose to engage with you. +6. **Better task management.** Content management requires a lot of tasks, which is why Experience Manager streamlines digital asset management to-dos. Easily add tasks to each project in your dashboard to stay on top of your workload. +7. **Easy integration.** Keep everything on the same platform. Whether you’re using third-party analytics or [Adobe Marketing Cloud](https://business.adobe.com/products/marketing-cloud/main.html), Experience Manager easily integrates with other tools. +8. **Flexibility and scalability.** Boost engagement by creating different content variations for all of your personas in just a few clicks. +9. **Add-on functionality.** If you need more specific functionality, Experience Manager add-ons are available through third parties and the Magento marketplace. + +## Integrating Experience Manager with other products + +While Experience Manager comes with a lot of features out of the box, organizations can also integrate Experience Manager with additional services to get even more value out of the platform. Try integrating it with other products, such as: + +- **Ecommerce software.** Experience Manager integrates with major ecommerce solutions to streamline content and asset management. It integrates with [Adobe Commerce](https://business.adobe.com/resources/why-adobe-commerce-better-cloud.html?gclid=Cj0KCQjwyLGjBhDKARIsAFRNgW_wRjl5l9mxwrEE--I0ZezqiIUA015NpgoUNokweL_ihcNqTco-RbAaAnwDEALw_wcB\&sdid=49F59KRV\&mv=search\&edtamo=true\&ef_id=Cj0KCQjwyLGjBhDKARIsAFRNgW_wRjl5l9mxwrEE--I0ZezqiIUA015NpgoUNokweL_ihcNqTco-RbAaAnwDEALw_wcB:G:s\&s_kwcid=AL!3085!3!645909280032!e!!g!!adobe%20commerce!16001298912!136314953927\&mv=search\&edtamo=true\&gad=1), BigCommerce, Shopify, WooCommerce, and more. +- **[Adobe Workfront](https://business.adobe.com/products/workfront/main.html).** Manage your team’s tasks and workflows by [integrating Workfront with Assets](https://business.adobe.com/products/workfront/aem-integration.html). This integration makes it easy to approve content, deliver assets, and publish content using the power of automation. +- **[Adobe Creative Cloud](https://www.adobe.com/creativecloud.html).** Whether you’re brainstorming content ideas or need creative variations for different platforms, [integrating Creative Cloud with Experience Manager](https://experienceleague.adobe.com/docs/experience-manager-cloud-service/content/assets/manage/cc-api-integration.html?lang=en#_blank) makes it possible to process assets at scale. Configure files in Experience Manager to effortlessly bulk process files with Lightroom Presets, Image Masks, and more. +- **[Adobe Target](https://business.adobe.com/products/target/adobe-target.html).** [Integrating Adobe Target with Experience Manager](https://experienceleague.adobe.com/docs/experience-manager-65/administering/integration/target.html?lang=en#_blank) makes it possible to personalize web content to each of your target personas. Target can show you which customers to focus on so you can message them more effectively with Experience Manager Sites, Screens, or Forms. +- **[Adobe Analytics Cloud](https://business.adobe.com/products/analytics/analytics-cloud.html).** Get a more complete view of your web activity by [integrating Analytics Cloud with Experience Manager.](https://experienceleague.adobe.com/docs/experience-manager-65/administering/integration/adobeanalytics.html?lang=en#_blank) Track the performance of your Adobe Forms and continue optimizing your content to encourage even more engagement at scale. + +## Getting started + +Adobe Experience Manager is an all-in-one suite that simplifies content and asset management at scale. It integrates with multiple solutions to streamline workflows, automate tasks, and provide a better customer experience. + +When you’re ready to get started, learn a little more, or try it for yourself, [get a demo of Adobe Experience Manager](https://business.adobe.com/products/experience-manager/adobe-experience-manager.html). + +[Experience Manager](https://business.adobe.com/products/experience-manager/adobe-experience-manager.html) combines digital asset management and content management into a unified solution for delivering timely, relevant, and personal experiences. It helps you source, adapt, automate, and deliver one-on-one digital experiences across web, IoT, and more — at any scale — powered by the latest AI. As a cloud service, Experience Manager is always on and up to date so you can make the most of your content and stay ahead of rising customer expectations. + +**[Watch the overview video](https://business.adobe.com/products/experience-manager/adobe-experience-manager.html#watch) to learn more.** + ++--------------------------------------------------x---------------------------------------------------+ +| Recommended articles | ++--------------------------------------------------x---------------------------------------------------+ +| | +| | +| | +| | +| | ++------------------------------------------------------------------------------------------------------+ + ++----------------------------------------x-----------------------------------------+ +| Metadata | ++-----------x------------+----------------------------x----------------------------+ +| Title | Adobe Experience Manager — what it is and how it works | ++-----------x------------+----------------------------x----------------------------+ +| | Adobe Experience Manager is a software solution that’s | +| Description | equal parts content management system (CMS) and digital | +| | asset management (DAM) system. | ++-----------x------------+----------------------------x----------------------------+ +| | \ | +| Author | Adobe Experience Cloud Team | ++-----------x------------+----------------------------x----------------------------+ +| | \ | +| Publication Date | 06-27-2023 | ++-----------x------------+----------------------------x----------------------------+ +| Category | Basics | ++-----------x------------+----------------------------x----------------------------+ +| | Content Management, Customer Success, Marketing | +| Tags | Automation, Personalization | ++-----------x------------+----------------------------x----------------------------+ +| Industry | N/A | ++-----------x------------+----------------------------x----------------------------+ +| Customer Journey Stage | Discover | ++-----------x------------+----------------------------x----------------------------+ +| primaryProductName | | ++-----------x------------+----------------------------x----------------------------+ +| Audience | Content Marketer, Digital Marketer, Marketing Executive | ++-----------x------------+----------------------------x----------------------------+ +| SEO-Article | Tier 2 | ++------------------------+---------------------------------------------------------+ + ++-------------------------------------------------------------------------------------------------+ +| Card Metadata | ++------------------+------------------------------------------------------------------------------+ +| Title | Adobe Experience Manager — what it is and how it works | ++------------------+------------------------------------------------------------------------------+ +| CardDate | 2023-06-27 | ++------------------+------------------------------------------------------------------------------+ +| CardImage | ![Adobe Experience Manager — what it is and how it works card image][image0] | ++------------------+------------------------------------------------------------------------------+ +| CardImageAltText | Adobe Experience Manager — what it is and how it works card image | ++------------------+------------------------------------------------------------------------------+ +| CardDescription | Adobe Experience Manager is a software solution that’s equal parts content | +| | management system (CMS) and digital asset management (DAM) system. | ++------------------+------------------------------------------------------------------------------+ +| primaryTag | caas:content-type/blog | ++------------------+------------------------------------------------------------------------------+ +| Tags | caas:content-type/blog, caas:cta/read-article | ++------------------+------------------------------------------------------------------------------+ + +[image0]: https://main--bacom-blog--adobecom.hlx.page/media_1d7b0ffdb7bb5b4d1de9a5680fc2fbe671c5f689f.png#width=2000&height=1000 + +[image1]: https://main--bacom-blog--adobecom.hlx.page/media_134a6d035fb68239a3fde3b37cd436b74ccbb5a09.png#width=2000&height=1000 + +[image2]: https://main--bacom-blog--adobecom.hlx.page/media_150d892bf5de0c8d1e6a814e3147dda11d4365ca6.png#width=2000&height=220 diff --git a/test/validation/mocks/adobe-experience-manager-updated-mismatched.md b/test/validation/mocks/adobe-experience-manager-updated-mismatched.md new file mode 100644 index 0000000..b6adb9b --- /dev/null +++ b/test/validation/mocks/adobe-experience-manager-updated-mismatched.md @@ -0,0 +1,243 @@ +# Adobe Experience Manager — what it is and how it works + +![Adobe Experience Manager — what it is and how it works][image0] + +Trying to keep track of all your digital content and assets — let alone organizing and using them effectively to reach your customers and earn their trust — is daunting, to say the least. + +As a business owner, you need a solution for managing all of your digital content. Maybe you’ve heard that Adobe Experience Manager can simplify digital content management, but you aren’t sure if it’s time to make the switch. + +Adobe Experience Manager combines digital asset management and content management into a unified solution for delivering timely, relevant, and personal experiences. This article will break down what Experience Manager is all about and show you why it’s the best option for comprehensive digital content management. + +This post will discuss: + +- [What Adobe Experience Manager is](https://main--business-website--adobe.hlx.page/blog/basics/adobe-experience-manager#what-is-adobe-experience-manager) +- [How Experience Manager works](https://main--business-website--adobe.hlx.page/blog/basics/adobe-experience-manager#how-experience-manager-works) +- [Key features of Experience Manager](https://main--business-website--adobe.hlx.page/blog/basics/adobe-experience-manager#key-features-of-adobe-experience-manager) +- [Benefits of Experience Manager](https://main--business-website--adobe.hlx.page/blog/basics/adobe-experience-manager#benefits-of-adobe-experience-manager) +- [Integrating Experience Manager with other products](https://main--business-website--adobe.hlx.page/blog/basics/adobe-experience-manager#integrating-experience-manager-with-other-products) +- [Getting started](https://main--business-website--adobe.hlx.page/blog/basics/adobe-experience-manager#mismatched-hash) + +## What is Adobe Experience Manager? + +[Adobe Experience Manager](https://business.adobe.com/products/experience-manager/this-is-a-mismatch.html) is a software solution that’s equal part content management system (CMS) and digital asset management (DAM) system. + +Experience Manager helps companies regain control over their digital content, which is often spread across numerous sites, channels, and apps — by providing much-needed structure for content management. This reduces the complexity of content management to save businesses time. + +[According to a 2021 Forrester report](https://www.forrester.com/blogs/agile-cms-moves-the-market-beyond-headless-forresters-just-released-wave-evaluation/?mismatch=true), Experience Manager is the most robust CMS on the market. More than [128,000 websites](https://mismatch.builtwith.com/cms/Adobe-Experience-Manager) rely on the agile setup of Experience Manager to manage their content. + +Unlike other solutions, Experience Manager allows you to manage and sync data and content across different internal systems as well as customer-facing channels. This amounts to a more comprehensive, unified customer experience that saves your team time while improving your public image. + +## How Experience Manager works + +Brands rely on Experience Manager because it encompasses several functions that work together to create a streamlined, simplified experience. Experience Manager allows you to manage [content mismatch, create responsive web designs,](https://business.adobe.com/products/experience-manager/sites/omnichannel-experiences.html) and more. + +Experience Manager works by combining these six time-saving solutions into a single platform. + +![Experience Manager combines six solutions][image1] + +### Content management system — Experience Manager Sites + +[Adobe Experience Manager Sites](https://business.adobe.com/products/experience-manager/sites/aem-sites.html) is a marketer- and developer-friendly content management system. With Experience Manager Sites, you can quickly build a website using templates and ready-to-use components. Developers can also customize the site with minimal code. + +Experience Manager Sites lets developers and marketers publish content simultaneously and seamlessly on nearly any platform or channel. Plus, its generative artificial intelligence tools make it easy to change the tone of voice, add content variations, and make universal changes to all content. + +Experience Manager Sites is perfect for creating personalized experiences for different customer segments. For example, if you’re a software company that caters to both businesses and individuals, you can create separate landing pages for both audiences in just a few clicks. + +Experience Manager Sites is fast, easy to use, and secure, so it’s a popular option for both resource-minded small businesses and busy enterprise teams. + +### Digital asset management — Experience Manager Assets + +[Adobe Experience Manager Assets](https://business.adobe.com/products/experience-manager/assets/aem-assets.html) is a [digital asset management system](https://business.adobe.com/in/index/topics/digital-asset-management.html#:~:text=A%20digital%20asset%20management%20\(DAM,Read%20the%20report%20now%20%3E) which is a cloud-based system that stores and organizes all of your digital files. Instead of trying to locate files between your employees’ separate computers and accounts, a DAM makes it easy for your team to access assets like images, videos, and even 3D models in a shared environment. + +For example, you can store a social media post template on the DAM and share it with your team. When you train your team to pull from this template, you’ll ensure that all social media posts follow your branding guidelines. Experience Manager Assets also tracks changes, so if anyone adjusts the templates, you can see it in the revision history. + +Experience Manager Assets lives on Adobe’s cloud, so you don’t have to worry about storing large files locally. Plus, Experience Manager Assets is fast, scalable, and integrates with other Adobe software to streamline your workflow. + +### Digital enrollment and forms + +Experience Manager includes digital enrollment and forms, which helps you build a smooth digital enrollment and onboarding journey from start to finish. This feature removes the need for paper, helping your business easily embrace digital transformation — all while speeding up your workflows. + +Digital enrollment and forms makes it easy to build digital forms, collect e-signatures, and kick off onboarding with simple automations. For example, sales teams can build onboarding forms for new clients instead of sending dozens of emails back and forth. Once the client completes onboarding and signs a contract, the system will automatically send the client a message about onboarding. This helps your sales team save time and gives clients a better experience. + +Whether you want to create forms for internal or external use, digital enrollment and forms are easy to use across multiple platforms. + +### Digital Screens + +[Digital Screens](https://business.adobe.com/products/experience-manager/sites/digital-signage.html) is a digital signage solution that gives marketers the ability to create and manage digital signage for stores and venues. With this feature, you can communicate with digital signs displayed in store, which makes Digital Screens ideal for omnichannel businesses. + +You can create and update the signage easily, as well as coordinate sign messages in multiple locations from one dashboard. For example, if your company has a brick-and-mortar presence, you can use Digital Screens to add smart product recommendations to in-store displays — and even customize the product suggestions based on each store’s clientele. This elevates the in-store experience, educates shoppers, and saves time for in-store staff. + +In a world where customers expect a consistent experience both online and offline, Digital Screens gives you the power to sync your marketing in the physical world with your online efforts. + +### Digital Guides + +Digital Guides is software for creating product documentation and supporting content. Digital Guides is a component content management system (CCMS), which isn’t to be confused with a CMS. This tool structures content by organizing it into components that you can easily change out as needed. + +For example, if you change a product feature, you need to ensure that all of your help documentation addresses that change so customers have a consistent experience. Without a CCMS, you would have to make this change manually. But Digital Guides makes it easy to make these changes at scale by easily swapping out content components. + +Product features change over time, and that can cause disruptions for both your employees and customers. Digital Guides helps you easily format and link your user guides to help everyone have a better experience. + +### Adobe Learning Manager + +[Adobe Learning Manager](https://business.adobe.com/products/learning-manager/adobe-learning-manager.html?gclid=Cj0KCQjwyLGjBhDKARIsAFRNgW8hdS4piiL5gSg22gPNFOXQoXQiDU8KXsykfRi3dgZTvNrFk7_jjLkaAo_pEALw_wcB\&sdid=SEMBRALMNA\&ef_id=Cj0KCQjwyLGjBhDKARIsAFRNgW8hdS4piiL5gSg22gPNFOXQoXQiDU8KXsykfRi3dgZTvNrFk7_jjLkaAo_pEALw_wcB:G:s\&s_kwcid=AL!3085!3!613272989017!e!!g!!adobe%20learning%20manager) is software that allows you to create your own training programs. You can use it for customer education, sales and partner training, franchise and in-store training, employee reskilling, and compliance training. + +Normally, it takes a lot of time to create personalized training for your business. But Learning Manager allows you to create both internal and external training with 86,000 ready-made courses from an existing content marketplace. It also comes with engaging features like gamification, leaderboards, and social learning. + +For example, you can use Learning Manager to train new managers in your organization on leadership best practices. Learning Manager also gives you the ability to engage customers with external-facing training, which can increase engagement and sales. + +![More than 128,000 websites rely on Adobe Experience Manager][image2] + +## Key features of Adobe Experience Manager + +Experience Manager comes packed with powerful features to streamline your workflows while creating an all-around better customer experience. + +### Project dashboard + +Experience Manager comes with a sleek, centralized dashboard that gives you a high-level view of all projects. Every project is a resource group represented as a tile for easy access. + +For example, all of your training materials might be under one tile in the dashboard. This helps you quickly access your different projects, as well as add tasks, assets, or external links for each project. + +### Out-of-the-box technology + +- Experience Manager is a plug-and-play platform that you can use with zero code. The user-friendly setup makes it easy for anyone to use, thanks to its: +- What you see is what you get (WYSIWYG) editor +- Editable templates and core components, such as headers and footers, with adjustable styling +- Responsive layout +- Add-ons + +While coding isn’t necessary to use Experience Manager, developers can still add custom code to personalize the platform even more. But you don’t need to be a development savant to use this platform effectively because of its: + +- **Low-code setup.** The low-code options in Experience Manager allow you to customize templates with very little coding knowledge. +- **Example code.** Experience Manager provides example code to show you what’s possible in the platform. +- **Open source.** Experience Manager is built on open-source Java. Developers can use open-source React and Angular Core components too. This means there’s a large developer community available to answer any questions you have about customizing Experience Manager. + +### Cloud service + +As a cloud platform, Experience Manager is very scalable. All of your users will always have access to the latest features. You don’t have to worry about the time or expense of managing your own IT resources since Adobe manages all upgrades for you. + +Adobe also takes cloud security seriously. Experience Manager has robust security features, including access management, encryption, and multifactor authentication. + +### Visual media conversion + +Resizing images and videos for every channel is time-consuming, especially if you have a lot of assets. The visual media conversion feature of Experience Manager allows you to convert files into different sizes and formats in bulk. + +For example, if you created a social media graphic for Twitter, Instagram, and Facebook, all of these channels have different image sizing and formatting limits. Visual media conversion allows you to quickly convert these images into the right sizes with just a few clicks. + +### Omnichannel content delivery + +The Experience Manager headless CMS facilitates omnichannel delivery. You can manage multiple websites — even if they’re in different languages — to create a full omnichannel experience for customers around the globe. Experience Manager allows you to share content on every channel, including mobile and Internet of Things (IoT) devices, to deliver a consistent experience across multiple touchpoints. + ++---------------------------------------------------------------------------------------------------------------+ +| quote (borders, align left) | ++-------------------------------------------------------x-------------------------------------------------------+ +| Adobe Experience Manager combines digital asset management and content management into a unified solution for | +| delivering timely, relevant, and personal experiences. | ++---------------------------------------------------------------------------------------------------------------+ + +## Benefits of Adobe Experience Manager + +Instead of using a piecemeal approach for your business, Experience Manager gives you multiple solutions rolled into one convenient platform. More businesses are investing in Experience Manager because of its: + +1. **Easy-to-use CMS.** You don’t need any special experience or training to manage content in Experience Manager. The intuitive platform allows non-technical users to easily manage content across multiple properties. +2. **Automated workflows.** Experience Manager automates tasks to keep the ball rolling for your teams. Use the artificial intelligence (AI) features to tag, crop, and distribute assets in record time. +3. **Improved search for digital assets.** Stop wondering where your images and videos are. Experience Manager pulls all of your digital assets into one place, making it easy to find and adapt content as needed. +4. **Personalized content.** Easily create content variations on each channel to create hyper-specific experiences for all of your target personas. +5. **Ability to target customers wherever they are.** Experience Manager gives you the ability to deliver targeted experiences, regardless of where customers choose to engage with you. +6. **Better task management.** Content management requires a lot of tasks, which is why Experience Manager streamlines digital asset management to-dos. Easily add tasks to each project in your dashboard to stay on top of your workload. +7. **Easy integration.** Keep everything on the same platform. Whether you’re using third-party analytics or [Adobe Marketing Cloud](https://business.adobe.com/products/marketing-cloud/main.html), Experience Manager easily integrates with other tools. +8. **Flexibility and scalability.** Boost engagement by creating different content variations for all of your personas in just a few clicks. +9. **Add-on functionality.** If you need more specific functionality, Experience Manager add-ons are available through third parties and the Magento marketplace. + +## Integrating Experience Manager with other products + +While Experience Manager comes with a lot of features out of the box, organizations can also integrate Experience Manager with additional services to get even more value out of the platform. Try integrating it with other products, such as: + +- **Ecommerce software.** Experience Manager integrates with major ecommerce solutions to streamline content and asset management. It integrates with [Adobe Commerce](https://business.adobe.com/resources/why-adobe-commerce-better-cloud.html?gclid=Cj0KCQjwyLGjBhDKARIsAFRNgW_wRjl5l9mxwrEE--I0ZezqiIUA015NpgoUNokweL_ihcNqTco-RbAaAnwDEALw_wcB\&sdid=49F59KRV\&mv=search\&edtamo=true\&ef_id=Cj0KCQjwyLGjBhDKARIsAFRNgW_wRjl5l9mxwrEE--I0ZezqiIUA015NpgoUNokweL_ihcNqTco-RbAaAnwDEALw_wcB:G:s\&s_kwcid=AL!3085!3!645909280032!e!!g!!adobe%20commerce!16001298912!136314953927\&mv=search\&edtamo=true\&gad=1), BigCommerce, Shopify, WooCommerce, and more. +- **[Adobe Workfront](https://business.adobe.com/products/workfront/main.html).** Manage your team’s tasks and workflows by [integrating Workfront with Assets](https://business.adobe.com/products/workfront/aem-integration.html). This integration makes it easy to approve content, deliver assets, and publish content using the power of automation. +- **[Adobe Creative Cloud](https://www.adobe.com/creativecloud.html).** Whether you’re brainstorming content ideas or need creative variations for different platforms, [integrating Creative Cloud with Experience Manager](https://experienceleague.adobe.com/docs/experience-manager-cloud-service/content/assets/manage/cc-api-integration.html?lang=en#_blank) makes it possible to process assets at scale. Configure files in Experience Manager to effortlessly bulk process files with Lightroom Presets, Image Masks, and more. +- **[Adobe Target](https://business.adobe.com/products/target/adobe-target.html).** [Integrating Adobe Target with Experience Manager](https://experienceleague.adobe.com/docs/experience-manager-65/administering/integration/target.html?lang=en#_blank) makes it possible to personalize web content to each of your target personas. Target can show you which customers to focus on so you can message them more effectively with Experience Manager Sites, Screens, or Forms. +- **[Adobe Analytics Cloud](https://business.adobe.com/products/analytics/analytics-cloud.html).** Get a more complete view of your web activity by [integrating Analytics Cloud with Experience Manager.](https://experienceleague.adobe.com/docs/experience-manager-65/administering/integration/adobeanalytics.html?lang=en#_blank) Track the performance of your Adobe Forms and continue optimizing your content to encourage even more engagement at scale. + +## Getting started + +Adobe Experience Manager is an all-in-one suite that simplifies content and asset management at scale. It integrates with multiple solutions to streamline workflows, automate tasks, and provide a better customer experience. + +When you’re ready to get started, learn a little more, or try it for yourself, [get a demo of Adobe Experience Manager](https://business.adobe.com/products/experience-manager/adobe-experience-manager.html). + +[Experience Manager](https://business.adobe.com/products/experience-manager/adobe-experience-manager.html) combines digital asset management and content management into a unified solution for delivering timely, relevant, and personal experiences. It helps you source, adapt, automate, and deliver one-on-one digital experiences across web, IoT, and more — at any scale — powered by the latest AI. As a cloud service, Experience Manager is always on and up to date so you can make the most of your content and stay ahead of rising customer expectations. + +**[Watch the overview video](https://business.adobe.com/products/experience-manager/adobe-experience-manager.html#watch) to learn more.** + ++--------------------------------------------------x---------------------------------------------------+ +| Recommended articles | ++--------------------------------------------------x---------------------------------------------------+ +| | +| | +| | +| | +| | ++------------------------------------------------------------------------------------------------------+ + ++----------------------------------------x-----------------------------------------+ +| Metadata | ++-----------x------------+----------------------------x----------------------------+ +| Title | Adobe Experience Manager — what it is and how it works | ++-----------x------------+----------------------------x----------------------------+ +| | Adobe Experience Manager is a software solution that’s | +| Description | equal parts content management system (CMS) and digital | +| | asset management (DAM) system. | ++-----------x------------+----------------------------x----------------------------+ +| | \ | +| Author | Adobe Experience Cloud Team | ++-----------x------------+----------------------------x----------------------------+ +| | \ | +| Publication Date | 06-27-2023 | ++-----------x------------+----------------------------x----------------------------+ +| Category | Basics | ++-----------x------------+----------------------------x----------------------------+ +| | Content Management, Customer Success, Marketing | +| Tags | Automation, Personalization | ++-----------x------------+----------------------------x----------------------------+ +| Industry | N/A | ++-----------x------------+----------------------------x----------------------------+ +| Customer Journey Stage | Discover | ++-----------x------------+----------------------------x----------------------------+ +| primaryProductName | | ++-----------x------------+----------------------------x----------------------------+ +| Audience | Content Marketer, Digital Marketer, Marketing Executive | ++-----------x------------+----------------------------x----------------------------+ +| SEO-Article | Tier 2 | ++------------------------+---------------------------------------------------------+ + ++-------------------------------------------------------------------------------------------------+ +| Card Metadata | ++------------------+------------------------------------------------------------------------------+ +| Title | Adobe Experience Manager — what it is and how it works | ++------------------+------------------------------------------------------------------------------+ +| CardDate | 2023-06-27 | ++------------------+------------------------------------------------------------------------------+ +| CardImage | ![Adobe Experience Manager — what it is and how it works card image][image0] | ++------------------+------------------------------------------------------------------------------+ +| CardImageAltText | Adobe Experience Manager — what it is and how it works card image | ++------------------+------------------------------------------------------------------------------+ +| CardDescription | Adobe Experience Manager is a software solution that’s equal parts content | +| | management system (CMS) and digital asset management (DAM) system. | ++------------------+------------------------------------------------------------------------------+ +| primaryTag | caas:content-type/blog | ++------------------+------------------------------------------------------------------------------+ +| Tags | caas:content-type/blog, caas:cta/read-article | ++------------------+------------------------------------------------------------------------------+ + ++-----------------------------------------------+ +| Hide Block | ++-------+---------------------------------------+ +| Entry | /blog/basics/adobe-experience-manager | ++-------+---------------------------------------+ +| Date | 2024-04-26 | ++-------+---------------------------------------+ + +[image0]: https://main--bacom-blog--adobecom.hlx.page/media_1d7b0ffdb7bb5b4d1de9a5680fc2fbe671c5f689f.png#width=2000&height=1000 + +[image1]: https://main--bacom-blog--adobecom.hlx.page/media_134a6d035fb68239a3fde3b37cd436b74ccbb5a09.png#width=2000&height=1000 + +[image2]: https://main--bacom-blog--adobecom.hlx.page/media_150d892bf5de0c8d1e6a814e3147dda11d4365ca6.png#width=2000&height=220 diff --git a/test/validation/mocks/adobe-experience-manager-updated.md b/test/validation/mocks/adobe-experience-manager-updated.md new file mode 100644 index 0000000..f12e880 --- /dev/null +++ b/test/validation/mocks/adobe-experience-manager-updated.md @@ -0,0 +1,243 @@ +# Adobe Experience Manager — what it is and how it works + +![Adobe Experience Manager — what it is and how it works][image0] + +Trying to keep track of all your digital content and assets — let alone organizing and using them effectively to reach your customers and earn their trust — is daunting, to say the least. + +As a business owner, you need a solution for managing all of your digital content. Maybe you’ve heard that Adobe Experience Manager can simplify digital content management, but you aren’t sure if it’s time to make the switch. + +Adobe Experience Manager combines digital asset management and content management into a unified solution for delivering timely, relevant, and personal experiences. This article will break down what Experience Manager is all about and show you why it’s the best option for comprehensive digital content management. + +This post will discuss: + +- [What Adobe Experience Manager is](https://main--business-website--adobe.hlx.page/blog/basics/adobe-experience-manager#what-is-adobe-experience-manager) +- [How Experience Manager works](https://main--business-website--adobe.hlx.page/blog/basics/adobe-experience-manager#how-experience-manager-works) +- [Key features of Experience Manager](https://main--business-website--adobe.hlx.page/blog/basics/adobe-experience-manager#key-features-of-adobe-experience-manager) +- [Benefits of Experience Manager](https://main--business-website--adobe.hlx.page/blog/basics/adobe-experience-manager#benefits-of-adobe-experience-manager) +- [Integrating Experience Manager with other products](https://main--business-website--adobe.hlx.page/blog/basics/adobe-experience-manager#integrating-experience-manager-with-other-products) +- [Getting started](https://main--business-website--adobe.hlx.page/blog/basics/adobe-experience-manager#getting-started) + +## What is Adobe Experience Manager? + +[Adobe Experience Manager](https://business.adobe.com/products/experience-manager/adobe-experience-manager.html) is a software solution that’s equal part content management system (CMS) and digital asset management (DAM) system. + +Experience Manager helps companies regain control over their digital content, which is often spread across numerous sites, channels, and apps — by providing much-needed structure for content management. This reduces the complexity of content management to save businesses time. + +[According to a 2021 Forrester report](https://www.forrester.com/blogs/agile-cms-moves-the-market-beyond-headless-forresters-just-released-wave-evaluation/), Experience Manager is the most robust CMS on the market. More than [128,000 websites](https://trends.builtwith.com/cms/Adobe-Experience-Manager) rely on the agile setup of Experience Manager to manage their content. + +Unlike other solutions, Experience Manager allows you to manage and sync data and content across different internal systems as well as customer-facing channels. This amounts to a more comprehensive, unified customer experience that saves your team time while improving your public image. + +## How Experience Manager works + +Brands rely on Experience Manager because it encompasses several functions that work together to create a streamlined, simplified experience. Experience Manager allows you to manage [content fragments, create responsive web designs,](https://business.adobe.com/products/experience-manager/sites/omnichannel-experiences.html) and more. + +Experience Manager works by combining these six time-saving solutions into a single platform. + +![Experience Manager combines six solutions][image1] + +### Content management system — Experience Manager Sites + +[Adobe Experience Manager Sites](https://business.adobe.com/products/experience-manager/sites/aem-sites.html) is a marketer- and developer-friendly content management system. With Experience Manager Sites, you can quickly build a website using templates and ready-to-use components. Developers can also customize the site with minimal code. + +Experience Manager Sites lets developers and marketers publish content simultaneously and seamlessly on nearly any platform or channel. Plus, its generative artificial intelligence tools make it easy to change the tone of voice, add content variations, and make universal changes to all content. + +Experience Manager Sites is perfect for creating personalized experiences for different customer segments. For example, if you’re a software company that caters to both businesses and individuals, you can create separate landing pages for both audiences in just a few clicks. + +Experience Manager Sites is fast, easy to use, and secure, so it’s a popular option for both resource-minded small businesses and busy enterprise teams. + +### Digital asset management — Experience Manager Assets + +[Adobe Experience Manager Assets](https://business.adobe.com/products/experience-manager/assets/aem-assets.html) is a [digital asset management system](https://business.adobe.com/in/index/topics/digital-asset-management.html#:~:text=A%20digital%20asset%20management%20\(DAM,Read%20the%20report%20now%20%3E) which is a cloud-based system that stores and organizes all of your digital files. Instead of trying to locate files between your employees’ separate computers and accounts, a DAM makes it easy for your team to access assets like images, videos, and even 3D models in a shared environment. + +For example, you can store a social media post template on the DAM and share it with your team. When you train your team to pull from this template, you’ll ensure that all social media posts follow your branding guidelines. Experience Manager Assets also tracks changes, so if anyone adjusts the templates, you can see it in the revision history. + +Experience Manager Assets lives on Adobe’s cloud, so you don’t have to worry about storing large files locally. Plus, Experience Manager Assets is fast, scalable, and integrates with other Adobe software to streamline your workflow. + +### Digital enrollment and forms + +Experience Manager includes digital enrollment and forms, which helps you build a smooth digital enrollment and onboarding journey from start to finish. This feature removes the need for paper, helping your business easily embrace digital transformation — all while speeding up your workflows. + +Digital enrollment and forms makes it easy to build digital forms, collect e-signatures, and kick off onboarding with simple automations. For example, sales teams can build onboarding forms for new clients instead of sending dozens of emails back and forth. Once the client completes onboarding and signs a contract, the system will automatically send the client a message about onboarding. This helps your sales team save time and gives clients a better experience. + +Whether you want to create forms for internal or external use, digital enrollment and forms are easy to use across multiple platforms. + +### Digital Screens + +[Digital Screens](https://business.adobe.com/products/experience-manager/sites/digital-signage.html) is a digital signage solution that gives marketers the ability to create and manage digital signage for stores and venues. With this feature, you can communicate with digital signs displayed in store, which makes Digital Screens ideal for omnichannel businesses. + +You can create and update the signage easily, as well as coordinate sign messages in multiple locations from one dashboard. For example, if your company has a brick-and-mortar presence, you can use Digital Screens to add smart product recommendations to in-store displays — and even customize the product suggestions based on each store’s clientele. This elevates the in-store experience, educates shoppers, and saves time for in-store staff. + +In a world where customers expect a consistent experience both online and offline, Digital Screens gives you the power to sync your marketing in the physical world with your online efforts. + +### Digital Guides + +Digital Guides is software for creating product documentation and supporting content. Digital Guides is a component content management system (CCMS), which isn’t to be confused with a CMS. This tool structures content by organizing it into components that you can easily change out as needed. + +For example, if you change a product feature, you need to ensure that all of your help documentation addresses that change so customers have a consistent experience. Without a CCMS, you would have to make this change manually. But Digital Guides makes it easy to make these changes at scale by easily swapping out content components. + +Product features change over time, and that can cause disruptions for both your employees and customers. Digital Guides helps you easily format and link your user guides to help everyone have a better experience. + +### Adobe Learning Manager + +[Adobe Learning Manager](https://business.adobe.com/products/learning-manager/adobe-learning-manager.html?gclid=Cj0KCQjwyLGjBhDKARIsAFRNgW8hdS4piiL5gSg22gPNFOXQoXQiDU8KXsykfRi3dgZTvNrFk7_jjLkaAo_pEALw_wcB\&sdid=SEMBRALMNA\&ef_id=Cj0KCQjwyLGjBhDKARIsAFRNgW8hdS4piiL5gSg22gPNFOXQoXQiDU8KXsykfRi3dgZTvNrFk7_jjLkaAo_pEALw_wcB:G:s\&s_kwcid=AL!3085!3!613272989017!e!!g!!adobe%20learning%20manager) is software that allows you to create your own training programs. You can use it for customer education, sales and partner training, franchise and in-store training, employee reskilling, and compliance training. + +Normally, it takes a lot of time to create personalized training for your business. But Learning Manager allows you to create both internal and external training with 86,000 ready-made courses from an existing content marketplace. It also comes with engaging features like gamification, leaderboards, and social learning. + +For example, you can use Learning Manager to train new managers in your organization on leadership best practices. Learning Manager also gives you the ability to engage customers with external-facing training, which can increase engagement and sales. + +![More than 128,000 websites rely on Adobe Experience Manager][image2] + +## Key features of Adobe Experience Manager + +Experience Manager comes packed with powerful features to streamline your workflows while creating an all-around better customer experience. + +### Project dashboard + +Experience Manager comes with a sleek, centralized dashboard that gives you a high-level view of all projects. Every project is a resource group represented as a tile for easy access. + +For example, all of your training materials might be under one tile in the dashboard. This helps you quickly access your different projects, as well as add tasks, assets, or external links for each project. + +### Out-of-the-box technology + +- Experience Manager is a plug-and-play platform that you can use with zero code. The user-friendly setup makes it easy for anyone to use, thanks to its: +- What you see is what you get (WYSIWYG) editor +- Editable templates and core components, such as headers and footers, with adjustable styling +- Responsive layout +- Add-ons + +While coding isn’t necessary to use Experience Manager, developers can still add custom code to personalize the platform even more. But you don’t need to be a development savant to use this platform effectively because of its: + +- **Low-code setup.** The low-code options in Experience Manager allow you to customize templates with very little coding knowledge. +- **Example code.** Experience Manager provides example code to show you what’s possible in the platform. +- **Open source.** Experience Manager is built on open-source Java. Developers can use open-source React and Angular Core components too. This means there’s a large developer community available to answer any questions you have about customizing Experience Manager. + +### Cloud service + +As a cloud platform, Experience Manager is very scalable. All of your users will always have access to the latest features. You don’t have to worry about the time or expense of managing your own IT resources since Adobe manages all upgrades for you. + +Adobe also takes cloud security seriously. Experience Manager has robust security features, including access management, encryption, and multifactor authentication. + +### Visual media conversion + +Resizing images and videos for every channel is time-consuming, especially if you have a lot of assets. The visual media conversion feature of Experience Manager allows you to convert files into different sizes and formats in bulk. + +For example, if you created a social media graphic for Twitter, Instagram, and Facebook, all of these channels have different image sizing and formatting limits. Visual media conversion allows you to quickly convert these images into the right sizes with just a few clicks. + +### Omnichannel content delivery + +The Experience Manager headless CMS facilitates omnichannel delivery. You can manage multiple websites — even if they’re in different languages — to create a full omnichannel experience for customers around the globe. Experience Manager allows you to share content on every channel, including mobile and Internet of Things (IoT) devices, to deliver a consistent experience across multiple touchpoints. + ++---------------------------------------------------------------------------------------------------------------+ +| quote (borders, align left) | ++-------------------------------------------------------x-------------------------------------------------------+ +| Adobe Experience Manager combines digital asset management and content management into a unified solution for | +| delivering timely, relevant, and personal experiences. | ++---------------------------------------------------------------------------------------------------------------+ + +## Benefits of Adobe Experience Manager + +Instead of using a piecemeal approach for your business, Experience Manager gives you multiple solutions rolled into one convenient platform. More businesses are investing in Experience Manager because of its: + +1. **Easy-to-use CMS.** You don’t need any special experience or training to manage content in Experience Manager. The intuitive platform allows non-technical users to easily manage content across multiple properties. +2. **Automated workflows.** Experience Manager automates tasks to keep the ball rolling for your teams. Use the artificial intelligence (AI) features to tag, crop, and distribute assets in record time. +3. **Improved search for digital assets.** Stop wondering where your images and videos are. Experience Manager pulls all of your digital assets into one place, making it easy to find and adapt content as needed. +4. **Personalized content.** Easily create content variations on each channel to create hyper-specific experiences for all of your target personas. +5. **Ability to target customers wherever they are.** Experience Manager gives you the ability to deliver targeted experiences, regardless of where customers choose to engage with you. +6. **Better task management.** Content management requires a lot of tasks, which is why Experience Manager streamlines digital asset management to-dos. Easily add tasks to each project in your dashboard to stay on top of your workload. +7. **Easy integration.** Keep everything on the same platform. Whether you’re using third-party analytics or [Adobe Marketing Cloud](https://business.adobe.com/products/marketing-cloud/main.html), Experience Manager easily integrates with other tools. +8. **Flexibility and scalability.** Boost engagement by creating different content variations for all of your personas in just a few clicks. +9. **Add-on functionality.** If you need more specific functionality, Experience Manager add-ons are available through third parties and the Magento marketplace. + +## Integrating Experience Manager with other products + +While Experience Manager comes with a lot of features out of the box, organizations can also integrate Experience Manager with additional services to get even more value out of the platform. Try integrating it with other products, such as: + +- **Ecommerce software.** Experience Manager integrates with major ecommerce solutions to streamline content and asset management. It integrates with [Adobe Commerce](https://business.adobe.com/resources/why-adobe-commerce-better-cloud.html?gclid=Cj0KCQjwyLGjBhDKARIsAFRNgW_wRjl5l9mxwrEE--I0ZezqiIUA015NpgoUNokweL_ihcNqTco-RbAaAnwDEALw_wcB\&sdid=49F59KRV\&mv=search\&edtamo=true\&ef_id=Cj0KCQjwyLGjBhDKARIsAFRNgW_wRjl5l9mxwrEE--I0ZezqiIUA015NpgoUNokweL_ihcNqTco-RbAaAnwDEALw_wcB:G:s\&s_kwcid=AL!3085!3!645909280032!e!!g!!adobe%20commerce!16001298912!136314953927\&mv=search\&edtamo=true\&gad=1), BigCommerce, Shopify, WooCommerce, and more. +- **[Adobe Workfront](https://business.adobe.com/products/workfront/main.html).** Manage your team’s tasks and workflows by [integrating Workfront with Assets](https://business.adobe.com/products/workfront/aem-integration.html). This integration makes it easy to approve content, deliver assets, and publish content using the power of automation. +- **[Adobe Creative Cloud](https://www.adobe.com/creativecloud.html).** Whether you’re brainstorming content ideas or need creative variations for different platforms, [integrating Creative Cloud with Experience Manager](https://experienceleague.adobe.com/docs/experience-manager-cloud-service/content/assets/manage/cc-api-integration.html?lang=en#_blank) makes it possible to process assets at scale. Configure files in Experience Manager to effortlessly bulk process files with Lightroom Presets, Image Masks, and more. +- **[Adobe Target](https://business.adobe.com/products/target/adobe-target.html).** [Integrating Adobe Target with Experience Manager](https://experienceleague.adobe.com/docs/experience-manager-65/administering/integration/target.html?lang=en#_blank) makes it possible to personalize web content to each of your target personas. Target can show you which customers to focus on so you can message them more effectively with Experience Manager Sites, Screens, or Forms. +- **[Adobe Analytics Cloud](https://business.adobe.com/products/analytics/analytics-cloud.html).** Get a more complete view of your web activity by [integrating Analytics Cloud with Experience Manager.](https://experienceleague.adobe.com/docs/experience-manager-65/administering/integration/adobeanalytics.html?lang=en#_blank) Track the performance of your Adobe Forms and continue optimizing your content to encourage even more engagement at scale. + +## Getting started + +Adobe Experience Manager is an all-in-one suite that simplifies content and asset management at scale. It integrates with multiple solutions to streamline workflows, automate tasks, and provide a better customer experience. + +When you’re ready to get started, learn a little more, or try it for yourself, [get a demo of Adobe Experience Manager](https://business.adobe.com/products/experience-manager/adobe-experience-manager.html). + +[Experience Manager](https://business.adobe.com/products/experience-manager/adobe-experience-manager.html) combines digital asset management and content management into a unified solution for delivering timely, relevant, and personal experiences. It helps you source, adapt, automate, and deliver one-on-one digital experiences across web, IoT, and more — at any scale — powered by the latest AI. As a cloud service, Experience Manager is always on and up to date so you can make the most of your content and stay ahead of rising customer expectations. + +**[Watch the overview video](https://business.adobe.com/products/experience-manager/adobe-experience-manager.html#watch) to learn more.** + ++--------------------------------------------------x---------------------------------------------------+ +| Recommended articles | ++--------------------------------------------------x---------------------------------------------------+ +| | +| | +| | +| | +| | ++------------------------------------------------------------------------------------------------------+ + ++----------------------------------------x-----------------------------------------+ +| Metadata | ++-----------x------------+----------------------------x----------------------------+ +| Title | Adobe Experience Manager — what it is and how it works | ++-----------x------------+----------------------------x----------------------------+ +| | Adobe Experience Manager is a software solution that’s | +| Description | equal parts content management system (CMS) and digital | +| | asset management (DAM) system. | ++-----------x------------+----------------------------x----------------------------+ +| | \ | +| Author | Adobe Experience Cloud Team | ++-----------x------------+----------------------------x----------------------------+ +| | \ | +| Publication Date | 06-27-2023 | ++-----------x------------+----------------------------x----------------------------+ +| Category | Basics | ++-----------x------------+----------------------------x----------------------------+ +| | Content Management, Customer Success, Marketing | +| Tags | Automation, Personalization | ++-----------x------------+----------------------------x----------------------------+ +| Industry | N/A | ++-----------x------------+----------------------------x----------------------------+ +| Customer Journey Stage | Discover | ++-----------x------------+----------------------------x----------------------------+ +| primaryProductName | | ++-----------x------------+----------------------------x----------------------------+ +| Audience | Content Marketer, Digital Marketer, Marketing Executive | ++-----------x------------+----------------------------x----------------------------+ +| SEO-Article | Tier 2 | ++------------------------+---------------------------------------------------------+ + ++-------------------------------------------------------------------------------------------------+ +| Card Metadata | ++------------------+------------------------------------------------------------------------------+ +| Title | Adobe Experience Manager — what it is and how it works | ++------------------+------------------------------------------------------------------------------+ +| CardDate | 2023-06-27 | ++------------------+------------------------------------------------------------------------------+ +| CardImage | ![Adobe Experience Manager — what it is and how it works card image][image0] | ++------------------+------------------------------------------------------------------------------+ +| CardImageAltText | Adobe Experience Manager — what it is and how it works card image | ++------------------+------------------------------------------------------------------------------+ +| CardDescription | Adobe Experience Manager is a software solution that’s equal parts content | +| | management system (CMS) and digital asset management (DAM) system. | ++------------------+------------------------------------------------------------------------------+ +| primaryTag | caas:content-type/blog | ++------------------+------------------------------------------------------------------------------+ +| Tags | caas:content-type/blog, caas:cta/read-article | ++------------------+------------------------------------------------------------------------------+ + ++-----------------------------------------------+ +| Hide Block | ++-------+---------------------------------------+ +| Entry | /blog/basics/adobe-experience-manager | ++-------+---------------------------------------+ +| Date | 2024-04-26 | ++-------+---------------------------------------+ + +[image0]: https://main--bacom-blog--adobecom.hlx.page/media_1d7b0ffdb7bb5b4d1de9a5680fc2fbe671c5f689f.png#width=2000&height=1000 + +[image1]: https://main--bacom-blog--adobecom.hlx.page/media_134a6d035fb68239a3fde3b37cd436b74ccbb5a09.png#width=2000&height=1000 + +[image2]: https://main--bacom-blog--adobecom.hlx.page/media_150d892bf5de0c8d1e6a814e3147dda11d4365ca6.png#width=2000&height=220 diff --git a/test/validation/mocks/list.json b/test/validation/mocks/list.json new file mode 100644 index 0000000..72b09a7 --- /dev/null +++ b/test/validation/mocks/list.json @@ -0,0 +1,7 @@ +[ + "/advertising", + "/affiliate-marketing-guide", + "/affinity-diagram-guide", + "/agile-daily-stand-up", + "/agile-development" +] diff --git a/test/validation/mocks/md-mocks/source/advertising.md b/test/validation/mocks/md-mocks/source/advertising.md new file mode 100644 index 0000000..d405449 --- /dev/null +++ b/test/validation/mocks/md-mocks/source/advertising.md @@ -0,0 +1,209 @@ +# Advertising + +![Advertising][image0] + +**Quick definition:** Advertising entails the paid promotion of marketing content with the aim of acquiring new customers. + +**Key takeaways:** + +- Advertising encompasses all the ways companies communicate with customers about a product. +- Digital advertising is unique in its ability to gather online user data and utilize it to better align with their interests in order to drive more brand engagement, leads, and sales. +- Advertising campaigns should be goal driven. It’s important to know what action you want customers to take after seeing the ad. +- Companies can use [cross-channel](https://business.adobe.com/blog/basics/cross-channel-marketing) advertising to reach out to customers throughout their journey, building on the information shown in previous ads. +- Digital advertising has changed the way consumers make brand choices, so companies need to be able to adapt quickly and reach customers where they are + +Answers to the following questions were surfaced in an interview with Austin Meisel, an Adobe corporate team trainer. + +[What is advertising?](https://business.adobe.com/blog/basics/advertising#what-is-advertising)\ +[What is programmatic advertising?](https://business.adobe.com/blog/basics/advertising#what-is-programmatic-advertising)\ +[What is the difference between marketing and advertising?](https://business.adobe.com/blog/basics/advertising#what-is-the-difference-between-marketing-and-advertising)\ +[How does digital advertising compare to traditional advertising?](https://business.adobe.com/blog/basics/advertising#how-does-digital-advertising-compare-to-traditional-advertising)\ +[How can technology improve advertising strategies?](https://business.adobe.com/blog/basics/advertising#how-can-technology-improve-advertising-strategies)\ +[What are some advertising strategies a company can employ?](https://business.adobe.com/blog/basics/advertising#what-are-some-advertising-strategies-a-company-can-employ)\ +[How does a company effectively advertise?](https://business.adobe.com/blog/basics/advertising#how-does-a-company-effectively-advertise)\ +[How has digital advertising changed the way customers engage with products?](https://business.adobe.com/blog/basics/advertising#how-has-digital-advertising-changed-the-way-customers-engage-with-products)\ +[What is the future of advertising?](https://business.adobe.com/blog/basics/advertising#what-is-the-future-of-advertising) + +## What is advertising? + +Advertising is the technique and practice brands use to bring products and services to the public’s notice for the purpose of getting them to respond to what a brand has to offer — whether product, service, cause, or idea. + +Advertising helps sustain brands. It’s focused on getting a message out to a [specific customer type](https://business.adobe.com/blog/basics/customer-segmentation) or audience in order to get them to take a certain action. Types of advertising include video, display, paid search, paid social, print, [email](https://business.adobe.com/blog/basics/email-campaign), radio, TV, and outdoor. + +## What is programmatic advertising? + +[Programmatic advertising](https://business.adobe.com/blog/basics/programmatic-advertising) is the automation of the advertising process: artificial intelligence (AI) software decides where and when ads are placed and automates the purchasing process. There are usually three types of people involved in programmatic advertising: + +- The buyer, who places the ad +- The publisher, who sells space for ads +- The broker, who facilitates these relationships + +Programmatic advertising automates the role of the broker. It helps people find where to place ads based on the criteria they've established to reach the people they are targeting. + +## What is the difference between marketing and advertising? + +Marketing is a wider discipline. It includes understanding your customers through research and then using that information to promote the value of the product you want them to buy. + +Marketing goes beyond telling customers about your product; it's also about understanding how your product relates to the customer and what value it will bring them. And then advertising is used to take action on that understanding. Advertising makes the product or service known to your customer. + +## How does digital advertising compare to traditional advertising? + +One of the benefits of digital advertising over traditional methods is that it provides an easier means to track a customer across their [journey](https://business.adobe.com/blog/basics/customer-journey-management). Compared to traditional advertising, you get more information about your customer and can build a better understanding of their behavior. + +Traditional advertisers couldn’t track a customer’s interests and past purchases and then make accurate purchase predictions based on them. With digital advertising, you can understand customer behavior in greater detail. And in turn, customers can develop a better feel for your brand via digital advertising. + +For example, say somebody finds your web page through search and then goes onto your social media platforms, starts following you, and sees your Instagram photos. If you want people to understand and further research your brand, digital advertising tends to be the favorite. + +But digital advertising can also be expensive, so if you don’t know who your target audience is or how to effectively reach them, you could spend a lot of money and not get the return you expect if you aren’t tracking your audience. + +Traditional advertising can still be relevant depending on the brand or what your goal is. Print advertising — that appears in newspapers or magazines — can help capture the essence of what the brand is and what it stands for, and it projects that concept to the audience. + +The problem with print advertising is that we don't know all the people it reaches. + +You can assume certain things based on a publication’s brand, but you don’t really have that actual data of who the people are. But you still get the benefit of building brand awareness and associating your brand with a certain idea. + +For example, if you run an ad in a publication like _Vogue_, you’re connecting your brand with the lifestyle offered by _Vogue_, which is different from the lifestyle offered by, say, _Harper’s_ or _Cat Fancy_. You're invoking a general feeling about your name. + +Television advertising has generally managed to adapt to the new market since many people now watch TV online. Advertisers can now track and connect with those customers through either source. + +Traditional TV advertising is still a valid option for marketing professionals because it allows them to tell a story visually. It’s interactive, in a sense, because it's more than just a phrase or one static image. With both TV and podcasts, you get to tell a story about your product or service. + +## How can technology improve advertising strategies? + +Technology can improve an advertising strategy by automating ad circulation, thereby targeting an interested audience from the first. + +Using AI and machine-learning technology to look at historical data is key. Doing so helps companies make decisions regarding how to pinpoint those moments when customers, who behave similarly, might potentially engage, or convert. Technology that tailors ads to customers and sends them on a [specific journey](https://business.adobe.com/blog/basics/customer-journey-orchestration) based on their past behavior and needs allows companies to understand and convert or retain customers. + +Companies need to be careful not to over-automate, though. Advertisers still need to have a hand in some of these decisions, as AI has its data interpretation limits. But AI and machine learning are helpful and effective in brands getting the most out of their digital marketing budgets and running more efficient campaigns that have a better return on investment (ROI). + +## What are some advertising strategies a company can employ? + +It’s true that encouraging customers to develop an [emotional connection with a brand or product is key to conversion.](https://www.thedrum.com/opinion/2022/02/14/emotional-advertising-how-and-why-brands-use-it-drive-sales) Another strategy is making a specific claim about your brand. You have to develop an association between the customer and the product. For example, you might imply that eating a certain food will make you feel healthier or happier or a specific brand of body wash will help you feel beautiful and luxurious. + +You can also convince a customer to join the bandwagon. You show them how other people are enjoying the brand, and ask why they haven’t engaged yet, since so many others have. To further convince them, you can offer promotional rewards. If the customer chooses to interact with your brand, they will get a discount or some other promotional benefit. + +Repetition is also key in keeping up brand recognition. And here’s where AI comes in: By targeting an audience and with brand exposure, you can encourage conversion little by little over time. + +Many companies run simultaneous ad campaigns across different channels. They may show the customer a [display ad](https://business.adobe.com/blog/basics/display-advertising), then later show them a [video ad](https://business.adobe.com/blog/basics/video-advertising) describing a few additional benefits of the product. All the ad types play into each other to solidify the brand’s significance and reliability as well as the product being offered. + +## How does a company effectively advertise? + +To effectively advertise, a company must have a goal. They will often think of advertising as a non-tangible item used to show people the brand is great. While that can be helpful to tie your brand to a specific product and reinforce your brand name, it’s important to make sure there is some goal you’re trying to achieve. + +You can change the goal as you get results back, but it's always important to make sure that you're working toward some goal, and you're analyzing that data to know what you do next. If you aren't, then you're not getting the ROI, and you're not sure how effective your advertising is. + +Furthermore, you must understand who your [target audience](https://business.adobe.com/blog/basics/audience-targeting) is, how they’ll respond emotionally to an advertising campaign, and what it takes to lead them to [conversion](https://business.adobe.com/blog/basics/conversion-rate). Advertising can run into problems when people don’t think about how to pattern certain associations to their product. + +In a perfect world, you’re reaching your target audience in the right place, at the right time, and with [relevant content](https://business.adobe.com/blog/basics/content-management-system). To effectively advertise, you need to target the right audience during the right point of the sales cycle. Do you want your ad to target a customer at the beginning when they’re trying to decide on a brand, or do you want to target somebody who’s already picked your brand and is now in your store looking at their options? + +Each ad is going to be different depending on your goal and what you want the customer to do, but it’s important to understand where that customer is in the sales funnel to then better tailor that advertising to them. + +## How has digital advertising changed the way customers engage with products? + +Traditionally, a customer goes into a store, looks at a variety of options, and chooses one. Later, at home, they use the product and decide if they would like to continue with it or choose a new brand. This is called the “moment of truth,” and it was with this type of conversion event in mind that advertising traditionally moved forward. + +Now, in the digital advertising age, customers can research multiple brands online and use information from social media, display ads, or reviews to choose a product. But today’s customers are just as human — [just as driven by emotion](https://www.widerfunnel.com/blog/how-users-make-buying-decisions/) — as yesterday’s. Even if you’re a brand that’s in the final running to be a product the customer purchases, customers are now making last-minute decisions to try a totally different brand, even up until the moment of purchase. + +The problem with digital advertising is that you’re not sure where you're falling in that funnel. You have to be agile enough to respond to customers in the right way, and catch their attention, at the moment that you know they're willing to change their mind. + +### How do companies know which customers to target with ads? + +Choosing which customers to target with which ads comes down to collecting first-party and behavioral data about user activity, and understanding how different users come to your site. + +You need to find out how customers learned about your brand, whether it was via: + +- A paid media ad +- An organic search +- Email advertising +- A link from another domain (a referral link) +- A social media campaign + +If your brand attracted a far smaller number of website visits during an email campaign than after a series of ad placements, you know more about your customers than you did before: They aren’t meaningfully responsive to your email campaign. Any elements contributing to the success of your paid media campaign should be applied to your email marketing strategy. Alternatively, you may decide to shift your email budget to paid media to maximize the impact of fewer channels to your bottom line. + +### How can companies advertise on a small budget? + +If you can’t pay, then you have to put in the work. There are a lot of free resources out there, such as social media pages or search engine optimization. You don’t have to go all in on a [paid search campaign](https://business.adobe.com/blog/basics/search-engine-marketing) — you can choose a few keywords and craft some text-based ads to appear on a search engine results page. + +You can craft an info-rich homepage and effective landing pages. And there’s no replacement for good content. Long-form content, in particular, yields [high conversion rates](https://www.impactplus.com/blog/long-form-content-vs.-short-form-content). + +### How can companies ensure their ads stand out without becoming annoying? + +There are a lot of little things that marketing channel publishers are doing to try to force the hand of customers to engage with an advertisement. For example, when YouTube first incorporated ads into videos on their platform, people were suddenly getting bombarded with ads they didn’t want to watch. + +As a solution, YouTube added an option where users could skip an ad after five seconds. Customers are still exposed to the ad, and can continue to watch it, but they have the option to skip it if doesn’t appeal to them. And it gives the advertiser five seconds to convince the customer to engage with their brand. + +As advertisers look for ways to stand out, they need to explain the value of their product to their customers in a succinct way. They also need to know which customers to target, what they’re likely to respond to, and what calls to action will drive conversions. + +### What does poor advertising look like? + +Advertising can be considered bad when it isn’t prudent, thoughtful, or conscious of what’s happening in the world. It can usually be tied back to some kind of social inappropriateness or a lack of awareness about the current market. There’s a lack of consideration about how an ad will be perceived. + +Inauthentic advertising is also a problem, like one brand copying another brand’s spontaneous moment. Inaccurate advertising — advertising that misrepresents a product — can also be considered bad. + +Also, any advertising that doesn’t target correctly or speak to the brand’s customer base won’t be effective. + +## What is the future of advertising? + +Advertising is growing increasingly specific, with a hyper-focus on first-party data. The trend is identifying specific customers and their specific behaviors and then understanding how to either target or retarget them. + +Privacy laws and regulations will also have an impact since data collection is so vital. We’ve seen some challenges already, such as how limited data can make it difficult to get the right ads or get the right information in front of your customers. And further restrictions on customers' first-party data will probably present some more challenges. + +But what we're finding is that there's a level of acceptance that customers have in the Americas. They understand that without giving some information to advertisers, the advertising experience will diminish. The ads you see won’t necessarily be relevant, and that’s one thing that creates a frustrating experience. + +Deloitte predicts that that [AI and programmatic advertising will dominate](https://www2.deloitte.com/de/de/pages/technology-media-and-telecommunications/articles/future-of-advertising.html), and that “traditional processes involving RFPs, human negotiations, and manual insertion orders will vanish from the digital advertising space.” + +Kate Scott-Dawkins at Essence Global concurs that AI will play a major role in the future of advertising. However, she doesn’t discount the importance of the human element in advertising, [stating that](https://essenceglobal.com/article/advertising-in-2030-expert-predictions-on-the-future-of-advertising) “companies will need to become more transparent, sustainable, and purpose-driven to meet the expectations of post-Millennial generations over the next decade.” + +### **People also view** + ++-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| Columns (contained, middle) | ++------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------+ +| **Other glossary terms** | **Related Adobe products** | +| | | +| [Demand-Side Platform](https://business.adobe.com/glossary/demand-side-platform.html)\ | [Experience Platform](https://business.adobe.com/products/experience-platform/adobe-experience-platform.html)\ | +| [Customer Segmentation](https://business.adobe.com/glossary/customer-segmentation.html)\ | [Adobe Advertising Cloud](https://business.adobe.com/products/advertising/adobe-advertising-cloud.html)\ | +| [Analytics](https://business.adobe.com/glossary/analytics.html)\ | [Adobe Campaign](https://business.adobe.com/products/campaign/adobe-campaign.html)\ | +| [Audience Targeting](https://business.adobe.com/glossary/audience-targeting.html) | [Adobe Analytics](https://business.adobe.com/products/analytics/adobe-analytics.html)\ | +| | [Marketo Engagement Platform](https://business.adobe.com/products/marketo/adobe-marketo.html) | ++------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------+ + ++------------------------------------------------------------------------------+ +| Metadata | ++------------------+-----------------------------------------------------------+ +| Title | What Is Advertising? \| Adobe Basics | ++------------------+-----------------------------------------------------------+ +| Description | Advertising is the process of using content to attract | +| | and convert customers on a non-owned property. Learn more | +| | about advertising from Adobe today. | ++------------------+-----------------------------------------------------------+ +| Category | basics | ++------------------+-----------------------------------------------------------+ +| Author | DX Adobe | ++------------------+-----------------------------------------------------------+ +| Publication Date | 03-26-2021 | ++------------------+-----------------------------------------------------------+ +| Tags | | ++------------------+-----------------------------------------------------------+ + ++------------------------------------------------------------------------------+ +| Card Metadata | ++------------------+-----------------------------------------------------------+ +| Title | Advertising | ++------------------+-----------------------------------------------------------+ +| CardDate | 2021-03-26 | ++------------------+-----------------------------------------------------------+ +| CardImage | ![Advertising card image][image0] | ++------------------+-----------------------------------------------------------+ +| CardImageAltText | Advertising card image | ++------------------+-----------------------------------------------------------+ +| CardDescription | Advertising is the process of using content to attract | +| | and convert customers on a non-owned property. Learn more | +| | about advertising from Adobe today. | ++------------------+-----------------------------------------------------------+ +| primaryTag | caas:content-type/blog | ++------------------+-----------------------------------------------------------+ +| Tags | caas:content-type/blog, caas:cta/read-article | ++------------------+-----------------------------------------------------------+ + +[image0]: https://main--bacom-blog--adobecom.hlx.page/media_1396b0662a5c21d3c19bb7008d7df2ac371a35075.png#width=2000&height=1000 diff --git a/test/validation/mocks/md-mocks/source/affiliate-marketing-guide.md b/test/validation/mocks/md-mocks/source/affiliate-marketing-guide.md new file mode 100644 index 0000000..da1530f --- /dev/null +++ b/test/validation/mocks/md-mocks/source/affiliate-marketing-guide.md @@ -0,0 +1,163 @@ +# Affiliate marketing: a simple guide + +![Affiliate Marketing: A Simple Guide][image0] + +In affiliate marketing, affiliates, or independent marketing partners, promote a brand's products or services in exchange for a commission on each website visitor, lead, or sale they generate. A brand may work with several parties in their affiliate marketing strategy, including: + +- **Affiliates**\ + Affiliates are individuals or companies that market a brand’s products or services on their own platforms, such as websites, blogs, and social media accounts. Affiliates produce content to show the value of a brand’s offerings to consumers. This content is designed to persuade potential customers to take actions like clicking on a link, signing up for a free trial, filling out a form, or purchasing a product. +- **Networks**\ + Networks are companies that connect brands and affiliates. A brand may join a network, which is usually an online platform, to find affiliates who would like to promote its products. An affiliate may sign up for a network to look for brands they’d like to promote and gain access to promotional texts or creatives. A few of the most popular affiliate programs include the [Commission Junction Affiliate](https://www.cj.com/) and [Pepperjam](https://www.pepperjam.com/). +- **Agencies**\ + Agencies are companies that match brands to affiliates and monitor affiliate programs. They are designed for brands who would like to take a hands-off approach to their affiliate marketing program or those unable to manage the process in-house. Unlike networks that are online platforms with multiple brands and affiliates, agencies are composed of professionals who use their connections to provide brands with the right affiliates. They also negotiate favorable commissions and measure program success. +- **Consumers**\ + Consumers are essential to the success of any affiliate marketing program. Affiliates must create compelling content to influence consumers to click on a link, fill out a form, or purchase a product. Affiliate marketing can be a powerful form of social proof. According to research, [88% of consumers trust online reviews](https://searchengineland.com/88-consumers-trust-online-reviews-much-personal-recommendations-195803) as much as personal recommendations. + +With a successfully executed affiliate marketing strategy, each party can realize significant benefits. + +## How does affiliate marketing work? + +While every affiliate marketing program has its own target audience, unique features, and budget, most of them function in a similar manner. + +### Brands create affiliate programs + +A brand will decide they’d like to use affiliate marketing to promote their offerings and increase revenues, in turn creating their own program and recruiting affiliates. Alternately, they use an agency or network to help them get up and running. It’s important to note agencies and networks aren’t necessary for the success of a brand or affiliate. However, they may be useful to those new to affiliate marketing. + +### Affiliates promote the brand on their platforms + +An affiliate will promote your brand on its website, blog, or social media outlets using articles, videos, advertisements, emails, or even podcasts. Every time a consumer clicks on your brand’s promotion, a [tracking cookie](https://www.awin.com/gb/affiliate-marketing/everything-you-need-to-know-about-affiliate-tracking) is stored in their browser. The cookie allows you to track the consumer’s behavior. + +### Consumers take action + +The consumer will likely be redirected to your website or landing page so they can make the desired action such as filling out a form or purchasing a product. Once they have answered the call to action, the cookie will activate so the affiliate will receive a commission based on the rules established for driving a lead or sale. + +### Brands and affiliates share revenue + +Since affiliate marketing depends on a revenue-sharing model and affiliates receive a set commission, some affiliates will earn more money than others for a number of reasons. First, they may publish higher-quality content and utilize proper SEO strategies. They may also have a superior website experience, a deeper understanding of what you’re selling, and an audience better suited for your products. + +Additionally, some affiliates may simply choose brands which pay higher commissions. The price of a product or service, industry, and value a brand sees in affiliate marketing will all play a role in commission rates. On average, however, an affiliate commission is [anywhere between 5 and 30%](https://monitorbacklinks.com/blog/affiliate/average-affiliate-commission-rates) of a sale. Commissions are usually paid out on a monthly or quarterly basis. + +The type of program affiliates choose may also influence their earning potential. Your program will likely fall into one of the following categories: + +- **High-paying, low-volume**\ + High-paying, low-volume affiliate programs involve niche products that deliver fewer selling opportunities yet offer higher payouts. They tend to be more competitive, so less experienced affiliates may have a difficult time succeeding with them. +- **Low-paying, high-volume**\ + Low-paying, high-volume affiliate programs are attractive because their products typically appeal to a large audience. They may be a good fit for affiliates that receive lots of site traffic. +- **High-paying, high-volume**\ + High-paying, high-volume affiliate programs appeal to a wide variety of people and pay higher commissions. Unfortunately, some participating affiliates implement obnoxious marketing tactics such as “spamming” content across engagement channels to draw consumer attention. + +### Brands track and measure ROI + +With a strategically designed affiliate marketing program, you can easily track and measure the marketing activity and success of your affiliates. You’ll be able to calculate ROI very effectively so there won’t be any uncertainty about the success of your program. + +## Benefits of affiliate marketing + +Affiliate marketing can be a great business option for your business on multiple levels. + +- **Affordability and control**\ + Since affiliates produce content to promote your products and services, you don’t have to create content or hire freelancers to do so. This makes affiliate marketing more affordable to implement and manage compared to other marketing methods. Additionally, you have control over your affiliate commission expenses, meaning you can choose budget-friendly rates which attract quality affiliates and you can decide whether you want to utilize an agency or network for support. +- **Increased brand awareness**\ + Affiliates help spread the word about your brand to new audiences that may have been unreachable in the past. Since their followers are learning about your brand from a trusted source, it’s likely many of these followers could become future customers. +- **Improved SEO**\ + No matter what you’re selling, affiliate marketing can help build more backlinks to your websites and social media pages. This can help motivate organic traffic and generate leads and sales, ultimately strengthening your [SEO strategy](https://blog.marketo.com/2016/04/7-simple-steps-for-a-solid-seo-strategy.html). +- **Low-risk**\ + Before you bring on affiliates, determine when and how much you’ll pay them. You won’t have to worry about any last-minute or surprise costs because the financial details will have been determined in advance. This can be a huge perk, especially if you’re a startup or smaller business with a limited budget. +- **Less time to manage**\ + Affiliate marketing requires less time and energy to manage than other types of marketing. For example, SEO won’t be effective unless you engage in consistent content creation, link building, and site optimization. Social media marketing involves fresh content and interaction with fans or followers on a regular basis. Once you get an affiliate marketing program up and running, your time commitment will be minimal. While you may have to keep in touch with affiliates and make payments, these tasks are fairly quick and routine. + +## Tips for your affiliate marketing strategy + +Having explored the benefits of affiliate marketing, let’s review some tips on implementing a strong strategy. + +### Fine-tune or create your product + +Before you start your affiliate marketing journey, make sure your new or already created product is perfected by gathering feedback from current customers, researching competitors, and refining messaging. You can’t create a poor or subpar product and hope affiliates will still be capable of selling it. Make sure to articulate the unique selling points which differentiate your product from competitors. + +### Find your niche and target market + +Once you’ve finalized your product, figure out what you’d like your angle, area, or focus to be. For example, if you’re in the beauty industry you may need to decide if your focus will be on eyelash extensions or natural makeup. From here, you will need to determine your target audience by using Google Analytics and other data analysis tools to target consumer segments who have purchased from you or expressed interest in your brand. + +### Find affiliates + +When it is time to search for affiliates, keep in mind not all are created equal. Make sure that the partners you choose can bring the following qualities and resources to the table: + +- **Professional digital assets**\ + Affiliate social media platforms and [websites should be appealing](https://blog.marketo.com/2018/09/what-you-need-to-know-to-build-a-website.html) in both form and function. Generic or “spammy” digital assets may repel existing and potential customers. +- **Align with your business focus**\ + Affiliates should be involved with consumer segments appropriate for your offerings. For example, if you’re selling handmade bath soaps, it doesn’t make sense to target a music-focused affiliate. You may want to consider a beauty blogger who enjoys reviewing unique makeup and personal care products. +- **Communicate well**\ + Ideally, your affiliates should have strong written and interpersonal communication skills. These are the types of individuals who will have the capability to present your brand with the degree of professionalism necessary to grow your audience. + +### Manage affiliates + +After you’ve recruited affiliates and set up tracking, it is time to start managing your program. Get into the habit of measuring affiliate results on a weekly or even daily basis. Doing so helps to re-evaluate partnerships with affiliates who aren’t performing well while incentivizing top performers by increasing commissions or providing free products and services. + +Pay your affiliates on time and communicate with them frequently so you can answer questions or address concerns. You may want to schedule monthly or quarterly meetings with your top-performing affiliates to continuously improve the partnership you have with one another. + +## Tips for becoming an affiliate marketer + +While affiliate marketing offers an excellent opportunity for brands to drive revenue, it also helps affiliates develop a generous income stream. If you’re intrigued by the idea of earning money as an [affiliate marketer](https://www.persuasion-nation.com/blog/9-things-must-know-become-affiliate-marketer), here are some handy tips. + +- **Choose a market focus and channel**\ + Go for a consumer market you’re particularly passionate or knowledgeable about. Then, figure out which channels you’re going to use to promote affiliate products. These may be websites, blogs, YouTube channels, or social media platforms. +- **Find relevant brands**\ + You can use an affiliate program like Pepperjam or the Commission Junction Affiliate to look for brands that may value you as an affiliate. You can also visit brand websites and search for information on how to join their affiliate programs. +- **Create quality content**\ + Once you’ve found a brand or two that would like to work with you, focus on generating [engaging content](https://blog.marketo.com/2017/04/less-but-better-4-practical-ways-to) to help you drive conversions. Discuss your own experiences with the products you’re promoting, integrate SEO best practices within your content, and develop messaging specific to your audience's interests. +- **Keep trust top of mind**\ + Building trust is the key to driving conversions. By only partnering with brands whose products you would actually purchase, actually testing products, and being honest about their benefits, you’re more likely to succeed. + +Affiliate marketing takes strategy and hard work for affiliate marketers just as much as it does for brands. However, if you’re willing to put in the necessary work, you can potentially enjoy significant rewards. These may include free merchandise samples, generous commissions, and advance exposure to groundbreaking products. + +## Let affiliate marketing work for you + +Regardless of your business size or industry, affiliate marketing can spell success for your business. It may be the perfect addition to your current digital marketing program, delivering the opportunity to maximize profits in an affordable, low-risk manner. Once you start earning money from affiliate marketing, you will find new ways to continually improve and grow the program. + +If you’d like to develop your own affiliate marketing program, [Adobe Commerce](https://business.adobe.com/products/magento/magento-commerce.html) can help. + +_Schedule your [free demo](https://business.adobe.com/products/magento/get-demo.html) today._ + ++-------------------------------------------------------------------------------------------+ +| Recommended articles | ++-------------------------------------------------------------------------------------------+ +| \ | +| \ | +| | ++-------------------------------------------------------------------------------------------+ + ++----------------------------------------------------------------------------+ +| Metadata | ++------------------+---------------------------------------------------------+ +| Description | Wondering how your business may benefit from affiliate | +| | marketing? Check out our informative guide to find out. | ++------------------+---------------------------------------------------------+ +| Author | Adobe Communications Team | ++------------------+---------------------------------------------------------+ +| Publication Date | 10-10-2020 | ++------------------+---------------------------------------------------------+ +| Category | basics | ++------------------+---------------------------------------------------------+ +| Tags | Marketing Executive, Commerce, Adobe Commerce | ++------------------+---------------------------------------------------------+ + ++------------------------------------------------------------------------------+ +| Card Metadata | ++------------------+-----------------------------------------------------------+ +| Title | Affiliate marketing: a simple guide | ++------------------+-----------------------------------------------------------+ +| CardDate | 2020-10-10 | ++------------------+-----------------------------------------------------------+ +| CardImage | ![Affiliate Marketing: A Simple Guide card image][image0] | ++------------------+-----------------------------------------------------------+ +| CardImageAltText | Affiliate Marketing: A Simple Guide card image | ++------------------+-----------------------------------------------------------+ +| CardDescription | Wondering how your business may benefit from affiliate | +| | marketing? Check out our informative guide to find out. | ++------------------+-----------------------------------------------------------+ +| primaryTag | caas:content-type/blog | ++------------------+-----------------------------------------------------------+ +| Tags | caas:content-type/blog, caas:cta/read-article, | +| | caas:products/adobe-commerce | ++------------------+-----------------------------------------------------------+ + +[image0]: https://main--bacom-blog--adobecom.hlx.page/media_150591153a2d6110ea10eaadda897981f364c5dda.jpeg#width=770&height=433 diff --git a/test/validation/mocks/md-mocks/source/affinity-diagram-guide.md b/test/validation/mocks/md-mocks/source/affinity-diagram-guide.md new file mode 100644 index 0000000..e00d816 --- /dev/null +++ b/test/validation/mocks/md-mocks/source/affinity-diagram-guide.md @@ -0,0 +1,171 @@ +# How to use affinity diagrams to organize your work + +![Co-workers in an office use affinity diagrams to organize their work.][image0] + +As a team leader, you’re tasked with helping your staff members reach their maximum potential while guiding your organization toward simultaneously achieving measurable, positive results. + +On top of that, you have to organize, manage, and process huge amounts of information. From data collected via surveys to the latest concepts developed during brainstorming sessions, it can be all too easy to get lost in the seemingly endless sea of information. + +Fortunately, there are a number of excellent [project management techniques and tools](https://business.adobe.com/blog/basics/quality-management) you can use to bring structure to your processes and put your organization’s data to work. One of the most popular methods is the practice of affinity diagramming, a simple yet effective tool that might just be exactly what you have been looking for to sort through all your information and keep your team on track. + +You might have heard of affinity diagrams, but you may also be looking for more information on how to use them to better organize your ideas and plan your work. In this article, you’ll learn what an affinity diagram is, how it can be used to organize data, and, most importantly, how you can incorporate it into your planning processes. + +Specifically, this post will cover: + +- [What affinity diagrams are](https://business.adobe.com/blog/basics/affinity-diagram-guide#what-are-affinity-diagrams) +- [The affinity diagramming process](https://business.adobe.com/blog/basics/affinity-diagram-guide#the-affinity-diagramming-process) +- [When and how to use affinity diagrams](https://business.adobe.com/blog/basics/affinity-diagram-guide#when-and-how-to-use-affinity-diagrams) +- [How to get started with affinity mapping](https://business.adobe.com/blog/basics/affinity-diagram-guide#start-organizing-your-ideas-with-affinity-mapping) + +## What are affinity diagrams? + +Affinity diagrams are used to generate, organize, and consolidate information about a process, problem, complex issue, or product. They are visualization tools that allow managers and their teams to express their raw ideas without conceptualizing them into fully thought-out processes or plans, and they are primarily used to document and structure the concepts developed during a brainstorming session. + +An affinity diagram provides a means of organizing large amounts of information collected on various topics. For instance, it can be used to consolidate survey or research study results, as well as user feedback. + +The goal of affinity diagramming — or “affinity mapping,” as it’s also called — is to cluster similar concepts together to make large amounts of complex work more manageable. These diagrams can be created in person using a large board or wall and sticky notes. Teams can also develop virtual affinity diagrams using digital tools. + +Now that you understand the broad definition of affinity diagrams, let’s take a deeper dive into the process of affinity mapping. + +## The affinity diagramming process + +The process of creating an affinity diagram will be similar, regardless of whether you’re working in person or online. Either way, you want to generate ideas, write them down, sort them, and then discuss the findings with your team. There are two major differences between in-person and virtual affinity diagramming — the tools used and the meeting location. + +Naturally, in-person affinity mapping requires you and your team to gather in a physical location, such as a conference room, and use tangible tools. The virtual alternative is more appealing to remote and hybrid teams, as everyone can contribute to the session using digital diagramming tools. + +Let’s take a closer look at what is involved in creating an affinity diagram. The process is broken down into the following four key steps: + +![To create an affinity diagram you need to record, sort, categorize, and prioritize.][image1] + +### 1. Record + +Once you’ve gathered your team and kicked off your affinity diagramming session, it’s time to begin recording ideas or pieces of data. In this case, assume that you and your staff have chosen to host an in-person affinity mapping meeting and use Post-it notes to record ideas. + +In this scenario, each team member would begin presenting ideas or pieces of data. As the team leader, you’d be tasked with writing down the concepts on the Post-it notes. It’s vital that only a single idea or data point be listed on each card. + +Each card will then be added to your affinity diagram. There’s no need to organize them in any particular way at this stage — just make sure that each note or card is visible. Continue brainstorming ideas and recording data points until your team runs out of steam. Don’t cut them short, even if your board starts looking a little crowded. + +### 2. Sort + +The goal of the second step in the affinity mapping process is to group all of your notes based on similarity. Start by having your entire team look over the ideas they generated during step one. + +From there, collectively begin moving the notes so that similar ideas are clustered together. For an ecommerce team, as an example, there might be ideas regarding site navigation, the checkout process, how to filter products, and mobile friendliness. + +One important thing to keep in mind is sound. Some teams prefer to sort in silence so that they can really focus on the process, whereas others choose to confer with one another to ensure that everyone is in agreement throughout the process as to what groups each idea should be placed in. Experiment with both methods to discover what works best for your team. + +After the sorting process, your affinity diagram should look much more organized. Most of your cards should have made it into a group, though there may be a few outliers. Still, don’t feel obligated to force every card into a category if it doesn’t belong there. + +### 3. Categorize + +Once you’ve sorted most of your unique ideas into groups, it’s time to give each of these clusters a name. Discuss the ideas present in each collection with your team and come up with a concise name that best summarizes the theme of that group. + +There’s more than one way to tackle this stage of affinity mapping. If you prefer, you and your team can create a couple of categories before sorting starts. You can also create categories as you go, but make sure to call out the name of the new theme to your team to keep everyone on the same page. + +No matter how you decide to categorize, the outcome should be the same — groups of similar ideas are now indexed under headings that represent the main idea or theme of that batch. + +### 4. Prioritize + +Now that all of your information is organized and categorized, your team should be able to see some trends take shape and begin to formulate a strategy based on the results. + +It can be a good idea to designate a team member to present each grouping. That person will share the individual items within the cluster so everyone has a clear picture of how the ideas on your board are categorized. + +You may also want to gather some after-action feedback from your team. Find out what may have surprised them about the information gathered during the session. Insights like these can help you better understand how information is disseminated among your team — and they may even reveal some collaboration or communication issues that you didn’t know existed until now. + +Finally, prioritize the ideas or groups that your colleagues believe are particularly important to the success of the project. There are several different tactics you can use to prioritize groups. Some teams vote on each idea and mark individual cards with dots to signify how many votes they receive. Alternatively, points can be assigned to different ideas based on how important they are to the team. + ++--------------------------------------------------------------------------------------------------------------------+ +| quote (borders, align left) | ++---------------------------------------------------------x----------------------------------------------------------+ +| Affinity diagrams help teams sort information gathered during research or brainstorming. Grouping similar concepts | +| together helps teams visualize data in an organized fashion. | ++--------------------------------------------------------------------------------------------------------------------+ + +## When and how to use affinity diagrams + +Affinity diagrams are useful when your team has a large amount of data to process, especially when that data covers a wide variety of topics. + +For example, take the question, “How can we improve our product?” This question could have many answers, and each could have a series of actionable items nestled within it, all of which need to be fully explored. Tackling large, complex goals like these is the perfect opportunity to use an affinity diagram. + +How you use the information gathered from the affinity mapping process will largely depend on your organization and the type of work you’re trying to accomplish. Generally, you and your team should come away from your affinity diagramming session with a better understanding of which projects or ideas are most important. You can use that information going forward to address the highest priority projects first and keep your staff focused on the most value-driven objectives. + +If your team is facing a more specific, narrow-focused problem, affinity mapping may not be the most sensible tool available to you. In such situations, other project management methodologies like [kanban](https://business.adobe.com/blog/basics/what-is-kanban) may be the better fit. For instance, if you already know that site navigation is impeding the user experience, develop ideas for remedying this issue and create a detailed to-do list with your [kanban board](https://business.adobe.com/blog/basics/kanban-board). + +## Start organizing your ideas with affinity mapping + +It’s clear that affinity mapping is an excellent way to organize ideas and set direction for your team. But you might now be wondering how to begin incorporating such a useful strategy into your planning and brainstorming processes. + +First, you’ll need to choose a location for your affinity diagramming activity, such as a conference room, online meeting room, or large office. Next, gather the necessary tools for affinity mapping, such as: + +- Post-it notes or index cards and tape +- Markers +- A whiteboard or flip-chart paper +- A virtual affinity diagramming tool + +After you’ve picked a site for your session and acquired the right tools, select the focus of your affinity diagramming exercise. For instance, decide whether you’re looking to solve a specific problem, brainstorm new ideas, or analyze the results of a survey. Once you know the “why,” you can then schedule a meeting with the necessary team members. + +### Boost productivity with Adobe Workfront + +As you can imagine, the productivity of your affinity mapping sessions hinges on a key factor — having the right tools in place. Creating an affinity diagram and managing complex projects is much easier with [Adobe Workfront](https://business.adobe.com/products/workfront/main.html), a collaborative work management solution that can help integrate your people, processes, data, and technology for better results across the organization. + +By optimizing and centralizing digital projects, cross-functional teams can connect, collaborate, and execute from anywhere to help them do their best work. + +**To learn more, [take a Workfront product tour](https://business.adobe.com/products/workfront/tour.html) or [watch the overview video](https://business.adobe.com/products/workfront/main.html#main).** + ++-------------------------------------------------------------------------------+ +| Recommended articles | ++-------------------------------------------------------------------------------+ +| | +| | +| | +| | +| | ++-------------------------------------------------------------------------------+ + ++---------------------------------------------------------------------------------+ +| Metadata | ++------------------------+--------------------------------------------------------+ +| Title | How to use affinity diagrams to organize your work | ++------------------------+--------------------------------------------------------+ +| Description | Affinity diagrams help teams sort information gathered | +| | during research or brainstorming. Grouping similar | +| | concepts helps teams visualize and organize data. | ++------------------------+--------------------------------------------------------+ +| Author | Adobe Experience Cloud Team | ++------------------------+--------------------------------------------------------+ +| Publication Date | 04-26-2023 | ++------------------------+--------------------------------------------------------+ +| Category | Basics | ++------------------------+--------------------------------------------------------+ +| Tags | Data Foundation, Procurement & Operations | ++------------------------+--------------------------------------------------------+ +| Customer Journey Stage | Discover | ++------------------------+--------------------------------------------------------+ +| Product | Adobe Workfront | ++------------------------+--------------------------------------------------------+ +| Audience | Data Scientist , Operations/COO , Project Manager | ++------------------------+--------------------------------------------------------+ +| SEO-Article | Tier 2 | ++------------------------+--------------------------------------------------------+ + ++----------------------------------------------------------------------------------------------------------------+ +| Card Metadata | ++------------------+---------------------------------------------------------------------------------------------+ +| Title | How to use affinity diagrams to organize your work | ++------------------+---------------------------------------------------------------------------------------------+ +| CardDate | 2023-04-26 | ++------------------+---------------------------------------------------------------------------------------------+ +| CardImage | ![Co-workers in an office use affinity diagrams to organize their work. card image][image0] | ++------------------+---------------------------------------------------------------------------------------------+ +| CardImageAltText | Co-workers in an office use affinity diagrams to organize their work. card image | ++------------------+---------------------------------------------------------------------------------------------+ +| CardDescription | Affinity diagrams help teams sort information gathered during research or brainstorming. | +| | Grouping similar concepts helps teams visualize and organize data. | ++------------------+---------------------------------------------------------------------------------------------+ +| primaryTag | caas:content-type/blog | ++------------------+---------------------------------------------------------------------------------------------+ +| Tags | caas:content-type/blog, caas:cta/read-article | ++------------------+---------------------------------------------------------------------------------------------+ + +[image0]: https://main--bacom-blog--adobecom.hlx.page/media_121eeacb954a3ffc093ca60775a5b12ab496a9c0a.png#width=2000&height=1000 + +[image1]: https://main--bacom-blog--adobecom.hlx.page/media_195a792ba321b4cb249495c411642a4aaedc1b2fb.png#width=2000&height=312 diff --git a/test/validation/mocks/md-mocks/source/agile-daily-stand-up.md b/test/validation/mocks/md-mocks/source/agile-daily-stand-up.md new file mode 100644 index 0000000..b4a8da3 --- /dev/null +++ b/test/validation/mocks/md-mocks/source/agile-daily-stand-up.md @@ -0,0 +1,175 @@ +# Daily stand-ups for agile teams + +![Daily stand-ups for agile teams marquee][image0] + +Whether you’re just getting started with agile or you’re looking for ways to improve, optimizing your meeting time is one of the best places to start. Daily stand-ups are a key part of agile project management and a quick overview will help you optimize every sprint. + +This post will help you understand: + +- [What stand-ups are](https://business.adobe.com/blog/basics/agile-daily-stand-up#what-is-a-stand-up) +- [How to run them effectively](https://business.adobe.com/blog/basics/agile-daily-stand-up#how-to-run-an-effective-stand-up--a-basic-framework) +- [Common mistakes to avoid](https://business.adobe.com/blog/basics/agile-daily-stand-up#common-daily-stand-up-mistakes-to-avoid) +- [How to run stand-ups for distributed and remote teams](https://business.adobe.com/blog/basics/agile-daily-stand-up#how-to-run-stand-ups-for-distributed-and-remote-teams) +- [Additional tips and best practices for great stand-ups](https://business.adobe.com/blog/basics/agile-daily-stand-up#additional-tips-and-best-practices-for-effective-stand-ups) + +## What is a stand-up? + +**A stand-up meeting is a short daily meeting that allows team members to talk about immediate progress and challenges with their work.** Participants discuss important tasks, address issues, and hold one another accountable for regular goals. Because everyone is standing, the meeting is necessarily short — 15 minutes is best — to allow everyone to participate and stay on task. + +The guiding principle of agile project management is breaking down projects into smaller sets of tasks (or sprints). Daily stand-ups are a critical component of this method because it is the very best way to keep the team organized as they proceed through their sprints to the finished product. + +![The Complete Guide to Agile Marketing screenshot][image1] + +## How to run an effective stand-up — a basic framework + +Although there are probably as many ways to run a stand-up as there are people standing up, some guidelines can help you get the most out of the meeting. There are two basic types of stand-up meetings — one is more agile and one is based on [kanban](https://business.adobe.com/blog/basics/what-is-kanban) project management . + +### Agile stand-ups + +Agile stand-ups — sometimes called “round robins” — are 15-minute standing meetings where team members discuss their tasks for a particular project. These meetings center on individual team members and their work, including how they can improve. The purpose of the agile stand-up is to break down a project into manageable pieces and help each team member be accountable for those pieces. + +### The three agile stand-up questions + +Every agile stand-up meeting is built around three questions that each team member answers. + +1\. What did I accomplish yesterday? + +2\. What will I do today? + +3\. What obstacles, if any, are impeding my progress? + +These questions are the heart of the agile stand-up. They give each team member a chance to be heard, offer support to one another, and ask for help when they need it. A project can easily get bogged down without this accountability and structure. + +### Kanban stand-ups + +Sometimes called “walking the board,” kanban stand-ups are similar to agile stand-ups in that they are brief, focused, and designed to give team members accountability and structure. But a kanban stand-up is based on a visual representation of the workflow — called a kanban board. + +The function of kanban stand-ups is to find bottlenecks and address them before they derail any part of the project. The focus is less individual and more about the most important tasks at hand. Kanban meetings are all about efficiency and moving work through the board to completion. + +## Common daily stand-up mistakes to avoid + +To get the most out of your stand-up meeting, there are some common pitfalls to watch out for. Avoid these mistakes and set your team up for success. + +### Taking too long + +A well-run stand-up is fast. It touches the important points quickly and allows team members to get back to work. If your stand-up is taking longer than 15 minutes, it’s probably too long. + +If anyone is sitting down, for example, you’re not really holding a stand-up. Keeping everyone on their feet is one way to adhere to the time limit because people are more likely to ramble on if they’re seated in comfy chairs. + +### Letting it become a status report meeting + +This is where many stand-ups go wrong. Daily stand-up meetings should be peer-to-peer communication, not reporting-to-manager commentary. The goal of a stand-up is to keep the team aligned and on the same page. + +The difference is often in the vibe of the meeting. An alignment meeting is collaborative and team-focused, allowing team members to talk about what they’re doing and what they need. In contrast, a status report meeting is a top-down arrangement where a few people talk and everyone else listens. The latter makes team members feel like they’re being micromanaged, which is _not_ the goal. + +![Man and women leading a stand-up meeting][image2] + +### Not discussing blockers + +Sometimes an entire stand-up will go by and there will be no blockers or problems to discuss. But if there are _never_ any blockers to talk about, something’s not right. No project ever goes off flawlessly. + +If you’re not hearing about blockers during stand-ups, it’s possible that your team members don’t feel comfortable talking about their challenges or asking for help. In that case, it’s up to the team leaders to recognize this and help those people engage. + +### Skipping it + +Everyone is busy, and it can seem like a big sacrifice to set aside time to meet every single day. Busy people can also get overwhelmed and miss meetings — even when they don’t mean to. Then there are days when the team might feel that the project is going well and there’s no need for a stand-up. + +But skipping the daily stand-up is a bad idea. If the team opts not to meet, they lose an opportunity to touch base and identify where each member is with tasks. If the team is meeting and a few people don’t make it, the team will move ahead without those people — and that could have a serious effect on their work and productivity. + +### Not helping the introverts + +Introverts sometimes struggle in groups, and it’s even worse when you add a bit of public speaking. Even those team members who _aren’t_ introverts may have a hard time talking in front of others. The team leader should identify those who show signs of stress during meetings and find ways to help them speak up when they need to. This can be as simple as providing some guidance on how to prepare ahead of time so they’re more confident. + +### Losing focus + +Agile stand-ups should be concise and everything discussed during the meeting should be relevant to the entire team. Long recitations, social interactions, or updates that don’t apply to everyone are inappropriate for a stand-up. + +Getting caught up in problem-solving is another common way that teams lose focus during a stand-up. There is a time and place for that, but the stand-up meeting is not it. + +## How to run stand-ups for distributed and remote teams + +You can hold effective stand-ups even if your team is spread out. With the remote connection options available now, you don’t have to be in the same time zone to have a stand-up meeting. + +There are a few ground rules for hosting a remote stand-up. + +- **Everyone is on their own computer.** When some team members are standing together and others are watching remotely, the in-person team tends to own the conversation. To keep your remote members from feeling isolated, level the playing field by putting everyone in front of their own screen. +- **Participants should view the meeting using a grid layout.** Your team members will feel equally valued and seen when all their faces are visible. +- **The meeting host should share the board.** If you’re using a kanban board or other visual, share it on the screen. Everyone looking at the board together fosters the sense of collaboration that is vital for an agile stand-up. + +\ +\ +Of course, when time zones don’t match up well, getting everyone on their computer at the same time can be difficult. That’s why asynchronous stand-ups are becoming more and more popular. In this format, daily meetings are replaced by written communication using a common platform that everyone on the team can access.\ +\ +Team members should be asked to answer the three agile stand-up questions in writing by a certain time — giving each member the freedom to do it when they can. + +![Additional tips and best practices graphic][image3] + +## Additional tips and best practices for effective stand-ups + +If you’re devoting time every day to a stand-up, you want that time to be productive. The best way to guarantee it’s not a waste of time is to adhere to a few basic best practices. + +1. **Hold your stand-up at the same time every day and at a time that works well for everyone.** Mornings are often best, but it’s not a requirement. It’s more important to ensure the meeting doesn’t interrupt workflow, so use that as your guiding scheduling principle. +2. **Keep your team engaged.** People can zone out even in a short meeting. First, ask team members to put their phones away during the stand-up. Then, find ways to keep people attentive that don't interrupt the conversation. You may try tossing a ball around the group during the meeting to keep people alert. Passing around a snack is another good way to keep people’s attention focused while not disrupting the conversation. +3. **Keep the team small.** If your team is too big, your meeting will be too long. It’s best to keep it to no more than 10 people — and fewer is better. If you have a large team, divide it half and have separate meetings. +4. **Stick to the schedule and use alarms.** Set one alarm for five minutes before the meeting to ensure no one is late, and set one for the end to guarantee a timely wrap-up. The alarm can be anything that gets the attention of your team — a pop-up on the calendar, a bell in the office, a song, or a gif or meme in the team chat. The options are endless. + +## Getting started with stand-up meetings + +Daily stand-ups are a key part of agile project management — and if they’re run well, they can improve the productivity and efficiency of your team. + +Start by explaining the concept to your team — including how it will work and why it’s important. Ask for their suggestions on the best time to schedule them and set up reminders for the start and end of each day’s stand-up. + +You may find that the software your team is using is holding back your agile project management style. [Adobe Workfront](https://www.workfront.com/products?ef_id=CjwKCAjwt7SWBhAnEiwAx8ZLanwVpwWWfg3sBPmqeKQ_ckwge7on8BLjXECwyLQOnLNhRnuSKZoJ0RoCeSwQAvD_BwE:G:s\&s_kwcid=AL!3085!3!517409436165!e!!g!!what%20is%20adobe%20workfront!10503449184!106943433994\&o=7010z000000ymxNAAQ\&utm_source=google\&utm_medium=cpc\&keyword=what%20is%20adobe%20workfront\&ad=517409436165\&matchtype=e\&device=c\&utm_campaign=us_brand_wf\&s_kwcid=AL!6440!3!517409436165!e!!g!!what%20is%20adobe%20workfront\&strala_id=ga-1-517409436165-106943433994\&strala_kw=what%20is%20adobe%20workfront\&strala_mt=e\&strala_dv=c\&strala_pl=\&strala_nw=g\&strala_ap=\&gclid=CjwKCAjwt7SWBhAnEiwAx8ZLanwVpwWWfg3sBPmqeKQ_ckwge7on8BLjXECwyLQOnLNhRnuSKZoJ0RoCeSwQAvD_BwE) is designed to help teams stay agile with features that streamline workflow and enhance the way you get things done. + +_**Take a free [product tour](https://www.workfront.com/tours/workfront) to see how Workfront can optimize your process.**_ + ++----------------------------------------------------------------------------------+ +| Metadata | ++------------------------+---------------------------------------------------------+ +| Title | Daily stand-ups for agile teams | ++------------------------+---------------------------------------------------------+ +| Description | A stand-up meeting is a short daily meeting that allows | +| | team members to talk about immediate progress and | +| | challenges with their work. | ++------------------------+---------------------------------------------------------+ +| Author | Adobe Communications Team | ++------------------------+---------------------------------------------------------+ +| Publication Date | 08-18-2022 | ++------------------------+---------------------------------------------------------+ +| Category | Basics | ++------------------------+---------------------------------------------------------+ +| Tags | Project Manager, Adobe Workfront | ++------------------------+---------------------------------------------------------+ +| Customer Journey Stage | Evaluate | ++------------------------+---------------------------------------------------------+ +| SEOArticle | Tier 1 | ++------------------------+---------------------------------------------------------+ + ++----------------------------------------------------------------------------+ +| Card Metadata | ++------------------+---------------------------------------------------------+ +| Title | Daily stand-ups for agile teams | ++------------------+---------------------------------------------------------+ +| CardDate | 2022-08-18 | ++------------------+---------------------------------------------------------+ +| CardImage | ![Daily stand-ups for agile teams card image][image0] | ++------------------+---------------------------------------------------------+ +| CardImageAltText | Daily stand-ups for agile teams card image | ++------------------+---------------------------------------------------------+ +| CardDescription | A stand-up meeting is a short daily meeting that allows | +| | team members to talk about immediate progress and | +| | challenges with their work. | ++------------------+---------------------------------------------------------+ +| primaryTag | caas:content-type/blog | ++------------------+---------------------------------------------------------+ +| Tags | caas:content-type/blog, caas:cta/read-article, | +| | caas:products/workfront | ++------------------+---------------------------------------------------------+ + +[image0]: https://main--bacom-blog--adobecom.hlx.page/media_10fb74f49e8af2116c2f516f5d5d61da33b304f05.png#width=2000&height=1000 + +[image1]: https://main--bacom-blog--adobecom.hlx.page/media_1514bf0c4f62b0bf896acd7c383b30442de267fef.png#width=2000&height=946 + +[image2]: https://main--bacom-blog--adobecom.hlx.page/media_1ad59421d12e0c7315aa0223798712abff2a0a8fa.png#width=2000&height=1010 + +[image3]: https://main--bacom-blog--adobecom.hlx.page/media_10d25fd1eeb59aaa04c47af0779a7ee1e1c96b6f3.png#width=2000&height=655 diff --git a/test/validation/mocks/md-mocks/source/agile-development.md b/test/validation/mocks/md-mocks/source/agile-development.md new file mode 100644 index 0000000..2f9a85a --- /dev/null +++ b/test/validation/mocks/md-mocks/source/agile-development.md @@ -0,0 +1,106 @@ +# Agile Development + +![agile developer in front of desktop][image0] + +Agile is a highly flexible approach to software development, tailored to the needs of modern teams. It facilitates an iterative method, highlighting continuous improvement to meet high-quality client deliverables collaboratively. In this article, learn how Agile development enables teams to deliver new products, features, and functionality more nimbly, and why it's an effective option for many development teams in fast-paced fields. + +[Take the product tour](https://www.workfront.com/tours/workfront) + +## What is Agile development? + +Agile development was born out of frustration with unreasonable delays seen with more traditional development practices, such as [Waterfall](https://www.workfront.com/project-management/methodologies/waterfall). This revolutionary approach to software development emphasizes continuous, incremental improvement and responsiveness to user needs, rather than highly planned, staggered product launches or updates. And although not limited to software, Agile has been particularly effective in this field, leading to more industries adopting this methodology to improve quality due to continuous collaboration with clients. + +From a practical perspective, Agile development allows teams to respond to client needs, implement constant feedback, and deliver higher-quality work. + +To illustrate the benefits of [Agile methodology](https://marketo.com/project-management/methodologies/agile) more fully, here is how it compares to the Waterfall method: + +### [Agile vs. Waterfall: Key contrasts.](https://www.workfront.com/project-management/methodologies/agile/agile-vs-waterfall) + +- **[Flexible planning vs. rigid approach](https://www.workfront.com/project-management/methodologies/agile/agile-vs-waterfall)**: Agile’s flexible planning approach accounts for constant client changes. Waterfall’s planning is comprehensive but not adaptive to change. Agile planning leads to rapid results, whereas Waterfall’s planning delays outcomes. +- **Constant testing vs. final product testing**: Agile development teams constantly test the product to make sure its characteristics meet client demands. Waterfall development teams only test the product once finalized, making changes close to impossible. +- **Continuous delivery vs. end-of-project deliverables**: Frequent delivery by Agile development teams enables enhancements as the project progresses. On the other hand, Waterfall development teams only deliver once the project is complete, leaving no room for product improvements. + +Learn more about the [differences between Agile and Waterfall](https://www.workfront.com/project-management/methodologies/agile/agile-vs-waterfall). + +## Agile development: Essential concepts. + +The [Agile Manifesto](https://www.workfront.com/project-management/methodologies/agile/agile-manifesto) comprises 12 overarching software development principles. Many of these principles focus on exceeding customer expectations through collaboration and [enhancing quality](https://www.workfront.com/project-management/knowledge-areas/quality-management) via continuous communication and deliverables. Below are essential Agile development concepts. + +### Accommodating changing requirements. + +Agile development highlights the value of meeting changing client needs as these take place. Should the client want an app addition or software improvement not discussed in the original plans, the Agile development team would embrace change after thorough discussion. Agile software development methods [adapt to project dynamics](https://www.workfront.com/resources/unlock-the-promise-of-agile-in-the-enterprise) as opposed to traditional methodologies that remain static. + +### Delivering working software. + +Software development teams using the Agile methodology tend to deliver working software by the time the project comes to an end. In contrast, the Waterfall method delivers software at the end of the project deadline, which may still require changes to operate as intended due to high concentrations of documentation. + +This difference means that keeping a constant eye on incremental changes and improvements in the Agile methodology is typically superior to Waterfall because of intense collaboration between cross-functional teams and clients. Although the Agile method may produce greater value than the Waterfall approach, some development teams may prefer to [combine them](https://www.workfront.com/resources/solve-the-pain-of-mixing-agile-and-waterfall) to adapt to organizational needs. + +### Continuously integrating user feedback and needs. + +Agile development teams actively place client needs before contract requirements. The consequence of this people-first approach is that teams listen and hear what their clients are saying. Feedback is taken seriously and integrated into projects to produce superior outcomes instead of strict adherence to original plans, which are not as [responsive to change](https://www.workfront.com/resources/20-experts-share-secrets-for-balancing-agile-and-waterfall). + +### Making an MVP. + +Building a minimum viable product (MVP) is a core concept of Agile development. Produce the product within certain parameters—such as its requirements, design, development, testing, and delivery—and learn from the real-time experience of how customers interact with the outcome. Following an iterative process of feedback and improvements requires ongoing learning that consequently leads to improved quality. Agile can formulate the MVP because the risks of introducing the market to new products are better managed. + +### Assessing opportunities for improvement. + +Agile development teams are notable for their drive to search for ways to make improvements. Instead of waiting for opportunities to come to them, software development teams actively look for ways to improve their products. Meetings, [scope management](https://marketo.com/project-management/knowledge-areas/scope-management), communication, benchmarking, and feedback are just some methods to assess opportunities for improvement on the path to delivering high-quality products. + +## Agile development approaches: Methodologies and practices. + +The Agile philosophy has continued to evolve since its inception in the early 2000s. In fact, it has blossomed into several distinct approaches and techniques that draw on Agile’s basic principles. + +[Four of these methodologies](https://www.workfront.com/project-management/methodologies) include: + +- **[Scrum](https://www.workfront.com/project-management/methodologies/scrum):** Scrum embraces the concept of sprints, which refer to tasks that teams need to complete in realistic time frames. Daily meetings guide the completion of each task in which teams share feedback on progress, obstacles experienced, and the plan to overcome those obstacles. A retrospective meeting ends each sprint to discuss progress and productivity. +- **[Kanban](https://www.workfront.com/project-management/methodologies/kanban):** Kanban highlights workflow optimization compared to other methodologies that concentrate on the cyclical nature of project processes. A Kanban visualization board helps team members imagine how their workflow can be improved within achievable work parameters for a stated period rather than taking on large workloads that are unachievable. During the visualization process, team members evaluate the workflow to determine where and how they can implement ongoing improvements. +- **Extreme programming (XP):** Team members produce software deliverables often with this methodology based on the concept that brief work cycles enhance productivity. This approach relies on frequent feedback to make improvements based on change requests rather than restricting work to the original scope definition. +- **Agile/Waterfall hybrid:** Traditional approaches like Waterfall still have their place in modern software development and project management. The difference is that software can facilitate a hybrid of frameworks to extract the best from each while limiting their respective shortfalls. + +## Adopting Agile: Beginning a new development approach. + +Agile software development is an effective way to manage projects that exhibit quality processes and performance. Flexible planning, testing, and team/client collaboration ensure that any enterprise can unlock its potential and produce successful outcomes. Organizations can benefit from using the Agile methodology to take software project development beyond what they previously envisioned. + +**To learn more about Audience Activation, check out our [documentation](https://experienceleague.adobe.com/docs/commerce-admin/customers/customers-menu/audience-activation.html?lang=en). Then visit the Marketplace to download the [extension](https://marketplace.magento.com/magento-audiences.html), exclusively for Commerce and Real-Time CDP customers. If you want to know more about brand-new personalization features in Commerce and see a demo of Audience Activation,** [**watch _Personalizing the Commerce Experience_ from Adobe Summit**](https://business.adobe.com/summit/2023/sessions/personalizing-the-commerce-experience-s508.html)**.** + ++------------------+----------------------------------------------------------+ +| Metadata | | ++==================+==========================================================+ +| Title | What is Agile Software Development? \| Adobe Workfront | ++------------------+----------------------------------------------------------+ +| Description | Learn how Agile can drive software development projects | +| | to produce high-performance deliverables. | ++------------------+----------------------------------------------------------+ +| Category | basics | ++------------------+----------------------------------------------------------+ +| Publication Date | 03-18-2022 | ++------------------+----------------------------------------------------------+ +| Author | Adobe Communications Team | ++------------------+----------------------------------------------------------+ +| Tags | Adobe Experience Cloud, Project Manager, Operations/COO, | +| | Marketing Executive, | ++------------------+----------------------------------------------------------+ + ++------------------------------------------------------------------------------+ +| Card Metadata | ++------------------+-----------------------------------------------------------+ +| Title | Agile Development | ++------------------+-----------------------------------------------------------+ +| CardDate | 2022-03-18 | ++------------------+-----------------------------------------------------------+ +| CardImage | ![agile developer in front of desktop card image][image0] | ++------------------+-----------------------------------------------------------+ +| CardImageAltText | agile developer in front of desktop card image | ++------------------+-----------------------------------------------------------+ +| CardDescription | Learn how Agile can drive software development projects | +| | to produce high-performance deliverables. | ++------------------+-----------------------------------------------------------+ +| primaryTag | caas:content-type/blog | ++------------------+-----------------------------------------------------------+ +| Tags | caas:content-type/blog, caas:cta/read-article, | +| | caas:business-unit/experience-cloud | ++------------------+-----------------------------------------------------------+ + +[image0]: https://main--bacom-blog--adobecom.hlx.page/media_13e7062e80919a8e8b3d369f7fefb30dfe8278126.jpeg#width=626&height=351 diff --git a/test/validation/mocks/md-mocks/updated/advertising.md b/test/validation/mocks/md-mocks/updated/advertising.md new file mode 100644 index 0000000..137c894 --- /dev/null +++ b/test/validation/mocks/md-mocks/updated/advertising.md @@ -0,0 +1,217 @@ +# Advertising + +![Advertising][image0] + +**Quick definition:** Advertising entails the paid promotion of marketing content with the aim of acquiring new customers. + +**Key takeaways:** + +- Advertising encompasses all the ways companies communicate with customers about a product. +- Digital advertising is unique in its ability to gather online user data and utilize it to better align with their interests in order to drive more brand engagement, leads, and sales. +- Advertising campaigns should be goal driven. It’s important to know what action you want customers to take after seeing the ad. +- Companies can use [cross-channel](https://business.adobe.com/blog/basics/cross-channel-marketing) advertising to reach out to customers throughout their journey, building on the information shown in previous ads. +- Digital advertising has changed the way consumers make brand choices, so companies need to be able to adapt quickly and reach customers where they are + +Answers to the following questions were surfaced in an interview with Austin Meisel, an Adobe corporate team trainer. + +[What is advertising?](https://business.adobe.com/blog/basics/advertising#what-is-advertising)\ +[What is programmatic advertising?](https://business.adobe.com/blog/basics/advertising#what-is-programmatic-advertising)\ +[What is the difference between marketing and advertising?](https://business.adobe.com/blog/basics/advertising#what-is-the-difference-between-marketing-and-advertising)\ +[How does digital advertising compare to traditional advertising?](https://business.adobe.com/blog/basics/advertising#how-does-digital-advertising-compare-to-traditional-advertising)\ +[How can technology improve advertising strategies?](https://business.adobe.com/blog/basics/advertising#how-can-technology-improve-advertising-strategies)\ +[What are some advertising strategies a company can employ?](https://business.adobe.com/blog/basics/advertising#what-are-some-advertising-strategies-a-company-can-employ)\ +[How does a company effectively advertise?](https://business.adobe.com/blog/basics/advertising#how-does-a-company-effectively-advertise)\ +[How has digital advertising changed the way customers engage with products?](https://business.adobe.com/blog/basics/advertising#how-has-digital-advertising-changed-the-way-customers-engage-with-products)\ +[What is the future of advertising?](https://business.adobe.com/blog/basics/advertising#what-is-the-future-of-advertising) + +## What is advertising? + +Advertising is the technique and practice brands use to bring products and services to the public’s notice for the purpose of getting them to respond to what a brand has to offer — whether product, service, cause, or idea. + +Advertising helps sustain brands. It’s focused on getting a message out to a [specific customer type](https://business.adobe.com/blog/basics/customer-segmentation) or audience in order to get them to take a certain action. Types of advertising include video, display, paid search, paid social, print, [email](https://business.adobe.com/blog/basics/email-campaign), radio, TV, and outdoor. + +## What is programmatic advertising? + +[Programmatic advertising](https://business.adobe.com/blog/basics/programmatic-advertising) is the automation of the advertising process: artificial intelligence (AI) software decides where and when ads are placed and automates the purchasing process. There are usually three types of people involved in programmatic advertising: + +- The buyer, who places the ad +- The publisher, who sells space for ads +- The broker, who facilitates these relationships + +Programmatic advertising automates the role of the broker. It helps people find where to place ads based on the criteria they've established to reach the people they are targeting. + +## What is the difference between marketing and advertising? + +Marketing is a wider discipline. It includes understanding your customers through research and then using that information to promote the value of the product you want them to buy. + +Marketing goes beyond telling customers about your product; it's also about understanding how your product relates to the customer and what value it will bring them. And then advertising is used to take action on that understanding. Advertising makes the product or service known to your customer. + +## How does digital advertising compare to traditional advertising? + +One of the benefits of digital advertising over traditional methods is that it provides an easier means to track a customer across their [journey](https://business.adobe.com/blog/basics/customer-journey-management). Compared to traditional advertising, you get more information about your customer and can build a better understanding of their behavior. + +Traditional advertisers couldn’t track a customer’s interests and past purchases and then make accurate purchase predictions based on them. With digital advertising, you can understand customer behavior in greater detail. And in turn, customers can develop a better feel for your brand via digital advertising. + +For example, say somebody finds your web page through search and then goes onto your social media platforms, starts following you, and sees your Instagram photos. If you want people to understand and further research your brand, digital advertising tends to be the favorite. + +But digital advertising can also be expensive, so if you don’t know who your target audience is or how to effectively reach them, you could spend a lot of money and not get the return you expect if you aren’t tracking your audience. + +Traditional advertising can still be relevant depending on the brand or what your goal is. Print advertising — that appears in newspapers or magazines — can help capture the essence of what the brand is and what it stands for, and it projects that concept to the audience. + +The problem with print advertising is that we don't know all the people it reaches. + +You can assume certain things based on a publication’s brand, but you don’t really have that actual data of who the people are. But you still get the benefit of building brand awareness and associating your brand with a certain idea. + +For example, if you run an ad in a publication like _Vogue_, you’re connecting your brand with the lifestyle offered by _Vogue_, which is different from the lifestyle offered by, say, _Harper’s_ or _Cat Fancy_. You're invoking a general feeling about your name. + +Television advertising has generally managed to adapt to the new market since many people now watch TV online. Advertisers can now track and connect with those customers through either source. + +Traditional TV advertising is still a valid option for marketing professionals because it allows them to tell a story visually. It’s interactive, in a sense, because it's more than just a phrase or one static image. With both TV and podcasts, you get to tell a story about your product or service. + +## How can technology improve advertising strategies? + +Technology can improve an advertising strategy by automating ad circulation, thereby targeting an interested audience from the first. + +Using AI and machine-learning technology to look at historical data is key. Doing so helps companies make decisions regarding how to pinpoint those moments when customers, who behave similarly, might potentially engage, or convert. Technology that tailors ads to customers and sends them on a [specific journey](https://business.adobe.com/blog/basics/customer-journey-orchestration) based on their past behavior and needs allows companies to understand and convert or retain customers. + +Companies need to be careful not to over-automate, though. Advertisers still need to have a hand in some of these decisions, as AI has its data interpretation limits. But AI and machine learning are helpful and effective in brands getting the most out of their digital marketing budgets and running more efficient campaigns that have a better return on investment (ROI). + +## What are some advertising strategies a company can employ? + +It’s true that encouraging customers to develop an [emotional connection with a brand or product is key to conversion.](https://www.thedrum.com/opinion/2022/02/14/emotional-advertising-how-and-why-brands-use-it-drive-sales) Another strategy is making a specific claim about your brand. You have to develop an association between the customer and the product. For example, you might imply that eating a certain food will make you feel healthier or happier or a specific brand of body wash will help you feel beautiful and luxurious. + +You can also convince a customer to join the bandwagon. You show them how other people are enjoying the brand, and ask why they haven’t engaged yet, since so many others have. To further convince them, you can offer promotional rewards. If the customer chooses to interact with your brand, they will get a discount or some other promotional benefit. + +Repetition is also key in keeping up brand recognition. And here’s where AI comes in: By targeting an audience and with brand exposure, you can encourage conversion little by little over time. + +Many companies run simultaneous ad campaigns across different channels. They may show the customer a [display ad](https://business.adobe.com/blog/basics/display-advertising), then later show them a [video ad](https://business.adobe.com/blog/basics/video-advertising) describing a few additional benefits of the product. All the ad types play into each other to solidify the brand’s significance and reliability as well as the product being offered. + +## How does a company effectively advertise? + +To effectively advertise, a company must have a goal. They will often think of advertising as a non-tangible item used to show people the brand is great. While that can be helpful to tie your brand to a specific product and reinforce your brand name, it’s important to make sure there is some goal you’re trying to achieve. + +You can change the goal as you get results back, but it's always important to make sure that you're working toward some goal, and you're analyzing that data to know what you do next. If you aren't, then you're not getting the ROI, and you're not sure how effective your advertising is. + +Furthermore, you must understand who your [target audience](https://business.adobe.com/blog/basics/audience-targeting) is, how they’ll respond emotionally to an advertising campaign, and what it takes to lead them to [conversion](https://business.adobe.com/blog/basics/conversion-rate). Advertising can run into problems when people don’t think about how to pattern certain associations to their product. + +In a perfect world, you’re reaching your target audience in the right place, at the right time, and with [relevant content](https://business.adobe.com/blog/basics/content-management-system). To effectively advertise, you need to target the right audience during the right point of the sales cycle. Do you want your ad to target a customer at the beginning when they’re trying to decide on a brand, or do you want to target somebody who’s already picked your brand and is now in your store looking at their options? + +Each ad is going to be different depending on your goal and what you want the customer to do, but it’s important to understand where that customer is in the sales funnel to then better tailor that advertising to them. + +## How has digital advertising changed the way customers engage with products? + +Traditionally, a customer goes into a store, looks at a variety of options, and chooses one. Later, at home, they use the product and decide if they would like to continue with it or choose a new brand. This is called the “moment of truth,” and it was with this type of conversion event in mind that advertising traditionally moved forward. + +Now, in the digital advertising age, customers can research multiple brands online and use information from social media, display ads, or reviews to choose a product. But today’s customers are just as human — [just as driven by emotion](https://www.widerfunnel.com/blog/how-users-make-buying-decisions/) — as yesterday’s. Even if you’re a brand that’s in the final running to be a product the customer purchases, customers are now making last-minute decisions to try a totally different brand, even up until the moment of purchase. + +The problem with digital advertising is that you’re not sure where you're falling in that funnel. You have to be agile enough to respond to customers in the right way, and catch their attention, at the moment that you know they're willing to change their mind. + +### How do companies know which customers to target with ads? + +Choosing which customers to target with which ads comes down to collecting first-party and behavioral data about user activity, and understanding how different users come to your site. + +You need to find out how customers learned about your brand, whether it was via: + +- A paid media ad +- An organic search +- Email advertising +- A link from another domain (a referral link) +- A social media campaign + +If your brand attracted a far smaller number of website visits during an email campaign than after a series of ad placements, you know more about your customers than you did before: They aren’t meaningfully responsive to your email campaign. Any elements contributing to the success of your paid media campaign should be applied to your email marketing strategy. Alternatively, you may decide to shift your email budget to paid media to maximize the impact of fewer channels to your bottom line. + +### How can companies advertise on a small budget? + +If you can’t pay, then you have to put in the work. There are a lot of free resources out there, such as social media pages or search engine optimization. You don’t have to go all in on a [paid search campaign](https://business.adobe.com/blog/basics/search-engine-marketing) — you can choose a few keywords and craft some text-based ads to appear on a search engine results page. + +You can craft an info-rich homepage and effective landing pages. And there’s no replacement for good content. Long-form content, in particular, yields [high conversion rates](https://www.impactplus.com/blog/long-form-content-vs.-short-form-content). + +### How can companies ensure their ads stand out without becoming annoying? + +There are a lot of little things that marketing channel publishers are doing to try to force the hand of customers to engage with an advertisement. For example, when YouTube first incorporated ads into videos on their platform, people were suddenly getting bombarded with ads they didn’t want to watch. + +As a solution, YouTube added an option where users could skip an ad after five seconds. Customers are still exposed to the ad, and can continue to watch it, but they have the option to skip it if doesn’t appeal to them. And it gives the advertiser five seconds to convince the customer to engage with their brand. + +As advertisers look for ways to stand out, they need to explain the value of their product to their customers in a succinct way. They also need to know which customers to target, what they’re likely to respond to, and what calls to action will drive conversions. + +### What does poor advertising look like? + +Advertising can be considered bad when it isn’t prudent, thoughtful, or conscious of what’s happening in the world. It can usually be tied back to some kind of social inappropriateness or a lack of awareness about the current market. There’s a lack of consideration about how an ad will be perceived. + +Inauthentic advertising is also a problem, like one brand copying another brand’s spontaneous moment. Inaccurate advertising — advertising that misrepresents a product — can also be considered bad. + +Also, any advertising that doesn’t target correctly or speak to the brand’s customer base won’t be effective. + +## What is the future of advertising? + +Advertising is growing increasingly specific, with a hyper-focus on first-party data. The trend is identifying specific customers and their specific behaviors and then understanding how to either target or retarget them. + +Privacy laws and regulations will also have an impact since data collection is so vital. We’ve seen some challenges already, such as how limited data can make it difficult to get the right ads or get the right information in front of your customers. And further restrictions on customers' first-party data will probably present some more challenges. + +But what we're finding is that there's a level of acceptance that customers have in the Americas. They understand that without giving some information to advertisers, the advertising experience will diminish. The ads you see won’t necessarily be relevant, and that’s one thing that creates a frustrating experience. + +Deloitte predicts that that [AI and programmatic advertising will dominate](https://www2.deloitte.com/de/de/pages/technology-media-and-telecommunications/articles/future-of-advertising.html), and that “traditional processes involving RFPs, human negotiations, and manual insertion orders will vanish from the digital advertising space.” + +Kate Scott-Dawkins at Essence Global concurs that AI will play a major role in the future of advertising. However, she doesn’t discount the importance of the human element in advertising, [stating that](https://essenceglobal.com/article/advertising-in-2030-expert-predictions-on-the-future-of-advertising) “companies will need to become more transparent, sustainable, and purpose-driven to meet the expectations of post-Millennial generations over the next decade.” + +### **People also view** + ++-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| Columns (contained, middle) | ++------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------+ +| **Other glossary terms** | **Related Adobe products** | +| | | +| [Demand-Side Platform](https://business.adobe.com/glossary/demand-side-platform.html)\ | [Experience Platform](https://business.adobe.com/products/experience-platform/adobe-experience-platform.html)\ | +| [Customer Segmentation](https://business.adobe.com/glossary/customer-segmentation.html)\ | [Adobe Advertising Cloud](https://business.adobe.com/products/advertising/adobe-advertising-cloud.html)\ | +| [Analytics](https://business.adobe.com/glossary/analytics.html)\ | [Adobe Campaign](https://business.adobe.com/products/campaign/adobe-campaign.html)\ | +| [Audience Targeting](https://business.adobe.com/glossary/audience-targeting.html) | [Adobe Analytics](https://business.adobe.com/products/analytics/adobe-analytics.html)\ | +| | [Marketo Engagement Platform](https://business.adobe.com/products/marketo/adobe-marketo.html) | ++------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------+ + ++------------------------------------------------------------------------------+ +| Metadata | ++------------------+-----------------------------------------------------------+ +| Title | What Is Advertising? \| Adobe Basics | ++------------------+-----------------------------------------------------------+ +| Description | Advertising is the process of using content to attract | +| | and convert customers on a non-owned property. Learn more | +| | about advertising from Adobe today. | ++------------------+-----------------------------------------------------------+ +| Category | basics | ++------------------+-----------------------------------------------------------+ +| Author | DX Adobe | ++------------------+-----------------------------------------------------------+ +| Publication Date | 03-26-2021 | ++------------------+-----------------------------------------------------------+ +| Tags | | ++------------------+-----------------------------------------------------------+ + ++------------------------------------------------------------------------------+ +| Card Metadata | ++------------------+-----------------------------------------------------------+ +| Title | Advertising | ++------------------+-----------------------------------------------------------+ +| CardDate | 2021-03-26 | ++------------------+-----------------------------------------------------------+ +| CardImage | ![Advertising card image][image0] | ++------------------+-----------------------------------------------------------+ +| CardImageAltText | Advertising card image | ++------------------+-----------------------------------------------------------+ +| CardDescription | Advertising is the process of using content to attract | +| | and convert customers on a non-owned property. Learn more | +| | about advertising from Adobe today. | ++------------------+-----------------------------------------------------------+ +| primaryTag | caas:content-type/blog | ++------------------+-----------------------------------------------------------+ +| Tags | caas:content-type/blog, caas:cta/read-article | ++------------------+-----------------------------------------------------------+ + ++----------------------------------+ +| Hide Block | ++-------+--------------------------+ +| Entry | /blog/basics/advertising | ++-------+--------------------------+ +| Date | 2024-04-26 | ++-------+--------------------------+ + +[image0]: https://main--bacom-blog--adobecom.hlx.page/media_1396b0662a5c21d3c19bb7008d7df2ac371a35075.png#width=2000&height=1000 diff --git a/test/validation/mocks/md-mocks/updated/affiliate-marketing-guide.md b/test/validation/mocks/md-mocks/updated/affiliate-marketing-guide.md new file mode 100644 index 0000000..7e5fc56 --- /dev/null +++ b/test/validation/mocks/md-mocks/updated/affiliate-marketing-guide.md @@ -0,0 +1,171 @@ +# Affiliate marketing: a simple guide + +![Affiliate Marketing: A Simple Guide][image0] + +In affiliate marketing, affiliates, or independent marketing partners, promote a brand's products or services in exchange for a commission on each website visitor, lead, or sale they generate. A brand may work with several parties in their affiliate marketing strategy, including: + +- **Affiliates**\ + Affiliates are individuals or companies that market a brand’s products or services on their own platforms, such as websites, blogs, and social media accounts. Affiliates produce content to show the value of a brand’s offerings to consumers. This content is designed to persuade potential customers to take actions like clicking on a link, signing up for a free trial, filling out a form, or purchasing a product. +- **Networks**\ + Networks are companies that connect brands and affiliates. A brand may join a network, which is usually an online platform, to find affiliates who would like to promote its products. An affiliate may sign up for a network to look for brands they’d like to promote and gain access to promotional texts or creatives. A few of the most popular affiliate programs include the [Commission Junction Affiliate](https://www.cj.com/) and [Pepperjam](https://www.pepperjam.com/). +- **Agencies**\ + Agencies are companies that match brands to affiliates and monitor affiliate programs. They are designed for brands who would like to take a hands-off approach to their affiliate marketing program or those unable to manage the process in-house. Unlike networks that are online platforms with multiple brands and affiliates, agencies are composed of professionals who use their connections to provide brands with the right affiliates. They also negotiate favorable commissions and measure program success. +- **Consumers**\ + Consumers are essential to the success of any affiliate marketing program. Affiliates must create compelling content to influence consumers to click on a link, fill out a form, or purchase a product. Affiliate marketing can be a powerful form of social proof. According to research, [88% of consumers trust online reviews](https://searchengineland.com/88-consumers-trust-online-reviews-much-personal-recommendations-195803) as much as personal recommendations. + +With a successfully executed affiliate marketing strategy, each party can realize significant benefits. + +## How does affiliate marketing work? + +While every affiliate marketing program has its own target audience, unique features, and budget, most of them function in a similar manner. + +### Brands create affiliate programs + +A brand will decide they’d like to use affiliate marketing to promote their offerings and increase revenues, in turn creating their own program and recruiting affiliates. Alternately, they use an agency or network to help them get up and running. It’s important to note agencies and networks aren’t necessary for the success of a brand or affiliate. However, they may be useful to those new to affiliate marketing. + +### Affiliates promote the brand on their platforms + +An affiliate will promote your brand on its website, blog, or social media outlets using articles, videos, advertisements, emails, or even podcasts. Every time a consumer clicks on your brand’s promotion, a [tracking cookie](https://www.awin.com/gb/affiliate-marketing/everything-you-need-to-know-about-affiliate-tracking) is stored in their browser. The cookie allows you to track the consumer’s behavior. + +### Consumers take action + +The consumer will likely be redirected to your website or landing page so they can make the desired action such as filling out a form or purchasing a product. Once they have answered the call to action, the cookie will activate so the affiliate will receive a commission based on the rules established for driving a lead or sale. + +### Brands and affiliates share revenue + +Since affiliate marketing depends on a revenue-sharing model and affiliates receive a set commission, some affiliates will earn more money than others for a number of reasons. First, they may publish higher-quality content and utilize proper SEO strategies. They may also have a superior website experience, a deeper understanding of what you’re selling, and an audience better suited for your products. + +Additionally, some affiliates may simply choose brands which pay higher commissions. The price of a product or service, industry, and value a brand sees in affiliate marketing will all play a role in commission rates. On average, however, an affiliate commission is [anywhere between 5 and 30%](https://monitorbacklinks.com/blog/affiliate/average-affiliate-commission-rates) of a sale. Commissions are usually paid out on a monthly or quarterly basis. + +The type of program affiliates choose may also influence their earning potential. Your program will likely fall into one of the following categories: + +- **High-paying, low-volume**\ + High-paying, low-volume affiliate programs involve niche products that deliver fewer selling opportunities yet offer higher payouts. They tend to be more competitive, so less experienced affiliates may have a difficult time succeeding with them. +- **Low-paying, high-volume**\ + Low-paying, high-volume affiliate programs are attractive because their products typically appeal to a large audience. They may be a good fit for affiliates that receive lots of site traffic. +- **High-paying, high-volume**\ + High-paying, high-volume affiliate programs appeal to a wide variety of people and pay higher commissions. Unfortunately, some participating affiliates implement obnoxious marketing tactics such as “spamming” content across engagement channels to draw consumer attention. + +### Brands track and measure ROI + +With a strategically designed affiliate marketing program, you can easily track and measure the marketing activity and success of your affiliates. You’ll be able to calculate ROI very effectively so there won’t be any uncertainty about the success of your program. + +## Benefits of affiliate marketing + +Affiliate marketing can be a great business option for your business on multiple levels. + +- **Affordability and control**\ + Since affiliates produce content to promote your products and services, you don’t have to create content or hire freelancers to do so. This makes affiliate marketing more affordable to implement and manage compared to other marketing methods. Additionally, you have control over your affiliate commission expenses, meaning you can choose budget-friendly rates which attract quality affiliates and you can decide whether you want to utilize an agency or network for support. +- **Increased brand awareness**\ + Affiliates help spread the word about your brand to new audiences that may have been unreachable in the past. Since their followers are learning about your brand from a trusted source, it’s likely many of these followers could become future customers. +- **Improved SEO**\ + No matter what you’re selling, affiliate marketing can help build more backlinks to your websites and social media pages. This can help motivate organic traffic and generate leads and sales, ultimately strengthening your [SEO strategy](https://blog.marketo.com/2016/04/7-simple-steps-for-a-solid-seo-strategy.html). +- **Low-risk**\ + Before you bring on affiliates, determine when and how much you’ll pay them. You won’t have to worry about any last-minute or surprise costs because the financial details will have been determined in advance. This can be a huge perk, especially if you’re a startup or smaller business with a limited budget. +- **Less time to manage**\ + Affiliate marketing requires less time and energy to manage than other types of marketing. For example, SEO won’t be effective unless you engage in consistent content creation, link building, and site optimization. Social media marketing involves fresh content and interaction with fans or followers on a regular basis. Once you get an affiliate marketing program up and running, your time commitment will be minimal. While you may have to keep in touch with affiliates and make payments, these tasks are fairly quick and routine. + +## Tips for your affiliate marketing strategy + +Having explored the benefits of affiliate marketing, let’s review some tips on implementing a strong strategy. + +### Fine-tune or create your product + +Before you start your affiliate marketing journey, make sure your new or already created product is perfected by gathering feedback from current customers, researching competitors, and refining messaging. You can’t create a poor or subpar product and hope affiliates will still be capable of selling it. Make sure to articulate the unique selling points which differentiate your product from competitors. + +### Find your niche and target market + +Once you’ve finalized your product, figure out what you’d like your angle, area, or focus to be. For example, if you’re in the beauty industry you may need to decide if your focus will be on eyelash extensions or natural makeup. From here, you will need to determine your target audience by using Google Analytics and other data analysis tools to target consumer segments who have purchased from you or expressed interest in your brand. + +### Find affiliates + +When it is time to search for affiliates, keep in mind not all are created equal. Make sure that the partners you choose can bring the following qualities and resources to the table: + +- **Professional digital assets**\ + Affiliate social media platforms and [websites should be appealing](https://blog.marketo.com/2018/09/what-you-need-to-know-to-build-a-website.html) in both form and function. Generic or “spammy” digital assets may repel existing and potential customers. +- **Align with your business focus**\ + Affiliates should be involved with consumer segments appropriate for your offerings. For example, if you’re selling handmade bath soaps, it doesn’t make sense to target a music-focused affiliate. You may want to consider a beauty blogger who enjoys reviewing unique makeup and personal care products. +- **Communicate well**\ + Ideally, your affiliates should have strong written and interpersonal communication skills. These are the types of individuals who will have the capability to present your brand with the degree of professionalism necessary to grow your audience. + +### Manage affiliates + +After you’ve recruited affiliates and set up tracking, it is time to start managing your program. Get into the habit of measuring affiliate results on a weekly or even daily basis. Doing so helps to re-evaluate partnerships with affiliates who aren’t performing well while incentivizing top performers by increasing commissions or providing free products and services. + +Pay your affiliates on time and communicate with them frequently so you can answer questions or address concerns. You may want to schedule monthly or quarterly meetings with your top-performing affiliates to continuously improve the partnership you have with one another. + +## Tips for becoming an affiliate marketer + +While affiliate marketing offers an excellent opportunity for brands to drive revenue, it also helps affiliates develop a generous income stream. If you’re intrigued by the idea of earning money as an [affiliate marketer](https://www.persuasion-nation.com/blog/9-things-must-know-become-affiliate-marketer), here are some handy tips. + +- **Choose a market focus and channel**\ + Go for a consumer market you’re particularly passionate or knowledgeable about. Then, figure out which channels you’re going to use to promote affiliate products. These may be websites, blogs, YouTube channels, or social media platforms. +- **Find relevant brands**\ + You can use an affiliate program like Pepperjam or the Commission Junction Affiliate to look for brands that may value you as an affiliate. You can also visit brand websites and search for information on how to join their affiliate programs. +- **Create quality content**\ + Once you’ve found a brand or two that would like to work with you, focus on generating [engaging content](https://blog.marketo.com/2017/04/less-but-better-4-practical-ways-to) to help you drive conversions. Discuss your own experiences with the products you’re promoting, integrate SEO best practices within your content, and develop messaging specific to your audience's interests. +- **Keep trust top of mind**\ + Building trust is the key to driving conversions. By only partnering with brands whose products you would actually purchase, actually testing products, and being honest about their benefits, you’re more likely to succeed. + +Affiliate marketing takes strategy and hard work for affiliate marketers just as much as it does for brands. However, if you’re willing to put in the necessary work, you can potentially enjoy significant rewards. These may include free merchandise samples, generous commissions, and advance exposure to groundbreaking products. + +## Let affiliate marketing work for you + +Regardless of your business size or industry, affiliate marketing can spell success for your business. It may be the perfect addition to your current digital marketing program, delivering the opportunity to maximize profits in an affordable, low-risk manner. Once you start earning money from affiliate marketing, you will find new ways to continually improve and grow the program. + +If you’d like to develop your own affiliate marketing program, [Adobe Commerce](https://business.adobe.com/products/magento/magento-commerce.html) can help. + +_Schedule your [free demo](https://business.adobe.com/products/magento/get-demo.html) today._ + ++-------------------------------------------------------------------------------------------+ +| Recommended articles | ++-------------------------------------------------------------------------------------------+ +| \ | +| \ | +| | ++-------------------------------------------------------------------------------------------+ + ++----------------------------------------------------------------------------+ +| Metadata | ++------------------+---------------------------------------------------------+ +| Description | Wondering how your business may benefit from affiliate | +| | marketing? Check out our informative guide to find out. | ++------------------+---------------------------------------------------------+ +| Author | Adobe Communications Team | ++------------------+---------------------------------------------------------+ +| Publication Date | 10-10-2020 | ++------------------+---------------------------------------------------------+ +| Category | basics | ++------------------+---------------------------------------------------------+ +| Tags | Marketing Executive, Commerce, Adobe Commerce | ++------------------+---------------------------------------------------------+ + ++------------------------------------------------------------------------------+ +| Card Metadata | ++------------------+-----------------------------------------------------------+ +| Title | Affiliate marketing: a simple guide | ++------------------+-----------------------------------------------------------+ +| CardDate | 2020-10-10 | ++------------------+-----------------------------------------------------------+ +| CardImage | ![Affiliate Marketing: A Simple Guide card image][image0] | ++------------------+-----------------------------------------------------------+ +| CardImageAltText | Affiliate Marketing: A Simple Guide card image | ++------------------+-----------------------------------------------------------+ +| CardDescription | Wondering how your business may benefit from affiliate | +| | marketing? Check out our informative guide to find out. | ++------------------+-----------------------------------------------------------+ +| primaryTag | caas:content-type/blog | ++------------------+-----------------------------------------------------------+ +| Tags | caas:content-type/blog, caas:cta/read-article, | +| | caas:products/adobe-commerce | ++------------------+-----------------------------------------------------------+ + ++------------------------------------------------+ +| Hide Block | ++-------+----------------------------------------+ +| Entry | /blog/basics/affiliate-marketing-guide | ++-------+----------------------------------------+ +| Date | 2024-04-26 | ++-------+----------------------------------------+ + +[image0]: https://main--bacom-blog--adobecom.hlx.page/media_150591153a2d6110ea10eaadda897981f364c5dda.jpeg#width=770&height=433 diff --git a/test/validation/mocks/md-mocks/updated/affinity-diagram-guide.md b/test/validation/mocks/md-mocks/updated/affinity-diagram-guide.md new file mode 100644 index 0000000..6c561cd --- /dev/null +++ b/test/validation/mocks/md-mocks/updated/affinity-diagram-guide.md @@ -0,0 +1,179 @@ +# How to use affinity diagrams to organize your work + +![Co-workers in an office use affinity diagrams to organize their work.][image0] + +As a team leader, you’re tasked with helping your staff members reach their maximum potential while guiding your organization toward simultaneously achieving measurable, positive results. + +On top of that, you have to organize, manage, and process huge amounts of information. From data collected via surveys to the latest concepts developed during brainstorming sessions, it can be all too easy to get lost in the seemingly endless sea of information. + +Fortunately, there are a number of excellent [project management techniques and tools](https://mismatch.adobe.com/blog/basics/quality-management) you can use to bring structure to your processes and put your organization’s data to work. One of the most popular methods is the practice of affinity diagramming, a simple yet effective tool that might just be exactly what you have been looking for to sort through all your information and keep your team on track. + +You might have heard of affinity diagrams, but you may also be looking for more information on how to use them to better organize your ideas and plan your work. In this article, you’ll learn what an affinity diagram is, how it can be used to organize data, and, most importantly, how you can incorporate it into your planning processes. + +Specifically, this post will cover: + +- [What affinity diagrams are](https://business.adobe.com/blog/basics/affinity-diagram-guide#mismatch) +- [The affinity diagramming process](https://business.adobe.com/blog/basics/affinity-diagram-guide#the-affinity-diagramming-process) +- [When and how to use affinity diagrams](https://business.adobe.com/blog/basics/affinity-diagram-guide#when-and-how-to-use-affinity-diagrams) +- [How to get started with affinity mapping](https://business.adobe.com/blog/basics/affinity-diagram-guide#start-organizing-your-ideas-with-affinity-mapping) + +## What are affinity diagrams? + +Affinity diagrams are used to generate, organize, and consolidate information about a process, problem, complex issue, or product. They are visualization tools that allow managers and their teams to express their raw ideas without conceptualizing them into fully thought-out processes or plans, and they are primarily used to document and structure the concepts developed during a brainstorming session. + +An affinity diagram provides a means of organizing large amounts of information collected on various topics. For instance, it can be used to consolidate survey or research study results, as well as user feedback. + +The goal of affinity diagramming — or “affinity mapping,” as it’s also called — is to cluster similar concepts together to make large amounts of complex work more manageable. These diagrams can be created in person using a large board or wall and sticky notes. Teams can also develop virtual affinity diagrams using digital tools. + +Now that you understand the broad definition of affinity diagrams, let’s take a deeper dive into the process of affinity mapping. + +## The affinity diagramming process + +The process of creating an affinity diagram will be similar, regardless of whether you’re working in person or online. Either way, you want to generate ideas, write them down, sort them, and then discuss the findings with your team. There are two major differences between in-person and virtual affinity diagramming — the tools used and the meeting location. + +Naturally, in-person affinity mapping requires you and your team to gather in a physical location, such as a conference room, and use tangible tools. The virtual alternative is more appealing to remote and hybrid teams, as everyone can contribute to the session using digital diagramming tools. + +Let’s take a closer look at what is involved in creating an affinity diagram. The process is broken down into the following four key steps: + +![To create an affinity diagram you need to record, sort, categorize, and prioritize.][image1] + +### 1. Record + +Once you’ve gathered your team and kicked off your affinity diagramming session, it’s time to begin recording ideas or pieces of data. In this case, assume that you and your staff have chosen to host an in-person affinity mapping meeting and use Post-it notes to record ideas. + +In this scenario, each team member would begin presenting ideas or pieces of data. As the team leader, you’d be tasked with writing down the concepts on the Post-it notes. It’s vital that only a single idea or data point be listed on each card. + +Each card will then be added to your affinity diagram. There’s no need to organize them in any particular way at this stage — just make sure that each note or card is visible. Continue brainstorming ideas and recording data points until your team runs out of steam. Don’t cut them short, even if your board starts looking a little crowded. + +### 2. Sort + +The goal of the second step in the affinity mapping process is to group all of your notes based on similarity. Start by having your entire team look over the ideas they generated during step one. + +From there, collectively begin moving the notes so that similar ideas are clustered together. For an ecommerce team, as an example, there might be ideas regarding site navigation, the checkout process, how to filter products, and mobile friendliness. + +One important thing to keep in mind is sound. Some teams prefer to sort in silence so that they can really focus on the process, whereas others choose to confer with one another to ensure that everyone is in agreement throughout the process as to what groups each idea should be placed in. Experiment with both methods to discover what works best for your team. + +After the sorting process, your affinity diagram should look much more organized. Most of your cards should have made it into a group, though there may be a few outliers. Still, don’t feel obligated to force every card into a category if it doesn’t belong there. + +### 3. Categorize + +Once you’ve sorted most of your unique ideas into groups, it’s time to give each of these clusters a name. Discuss the ideas present in each collection with your team and come up with a concise name that best summarizes the theme of that group. + +There’s more than one way to tackle this stage of affinity mapping. If you prefer, you and your team can create a couple of categories before sorting starts. You can also create categories as you go, but make sure to call out the name of the new theme to your team to keep everyone on the same page. + +No matter how you decide to categorize, the outcome should be the same — groups of similar ideas are now indexed under headings that represent the main idea or theme of that batch. + +### 4. Prioritize + +Now that all of your information is organized and categorized, your team should be able to see some trends take shape and begin to formulate a strategy based on the results. + +It can be a good idea to designate a team member to present each grouping. That person will share the individual items within the cluster so everyone has a clear picture of how the ideas on your board are categorized. + +You may also want to gather some after-action feedback from your team. Find out what may have surprised them about the information gathered during the session. Insights like these can help you better understand how information is disseminated among your team — and they may even reveal some collaboration or communication issues that you didn’t know existed until now. + +Finally, prioritize the ideas or groups that your colleagues believe are particularly important to the success of the project. There are several different tactics you can use to prioritize groups. Some teams vote on each idea and mark individual cards with dots to signify how many votes they receive. Alternatively, points can be assigned to different ideas based on how important they are to the team. + ++--------------------------------------------------------------------------------------------------------------------+ +| quote (borders, align left) | ++---------------------------------------------------------x----------------------------------------------------------+ +| Affinity diagrams help teams sort information gathered during research or brainstorming. Grouping similar concepts | +| together helps teams visualize data in an organized fashion. | ++--------------------------------------------------------------------------------------------------------------------+ + +## When and how to use affinity diagrams + +Affinity diagrams are useful when your team has a large amount of data to process, especially when that data covers a wide variety of topics. + +For example, take the question, “How can we improve our product?” This question could have many answers, and each could have a series of actionable items nestled within it, all of which need to be fully explored. Tackling large, complex goals like these is the perfect opportunity to use an affinity diagram. + +How you use the information gathered from the affinity mapping process will largely depend on your organization and the type of work you’re trying to accomplish. Generally, you and your team should come away from your affinity diagramming session with a better understanding of which projects or ideas are most important. You can use that information going forward to address the highest priority projects first and keep your staff focused on the most value-driven objectives. + +If your team is facing a more specific, narrow-focused problem, affinity mapping may not be the most sensible tool available to you. In such situations, other project management methodologies like [mismatch](https://business.adobe.com/blog/basics/what-is-kanban) may be the better fit. For instance, if you already know that site navigation is impeding the user experience, develop ideas for remedying this issue and create a detailed to-do list with your [kanban board](https://business.adobe.com/blog/basics/kanban-board). + +## Start organizing your ideas with affinity mapping + +It’s clear that affinity mapping is an excellent way to organize ideas and set direction for your team. But you might now be wondering how to begin incorporating such a useful strategy into your planning and brainstorming processes. + +First, you’ll need to choose a location for your affinity diagramming activity, such as a conference room, online meeting room, or large office. Next, gather the necessary tools for affinity mapping, such as: + +- Post-it notes or index cards and tape +- Markers +- A whiteboard or flip-chart paper +- A virtual affinity diagramming tool + +After you’ve picked a site for your session and acquired the right tools, select the focus of your affinity diagramming exercise. For instance, decide whether you’re looking to solve a specific problem, brainstorm new ideas, or analyze the results of a survey. Once you know the “why,” you can then schedule a meeting with the necessary team members. + +### Boost productivity with Adobe Workfront + +As you can imagine, the productivity of your affinity mapping sessions hinges on a key factor — having the right tools in place. Creating an affinity diagram and managing complex projects is much easier with [Adobe Workfront](https://business.adobe.com/products/workfront/main.html), a collaborative work management solution that can help integrate your people, processes, data, and technology for better results across the organization. + +By optimizing and centralizing digital projects, cross-functional teams can connect, collaborate, and execute from anywhere to help them do their best work. + +**To learn more, [take a Workfront product tour](https://business.adobe.com/products/workfront/tour.html) or [watch the overview video](https://business.adobe.com/products/workfront/main.html#main).** + ++-------------------------------------------------------------------------------+ +| Recommended articles | ++-------------------------------------------------------------------------------+ +| | +| | +| | +| | +| | ++-------------------------------------------------------------------------------+ + ++---------------------------------------------------------------------------------+ +| Metadata | ++------------------------+--------------------------------------------------------+ +| Title | How to use affinity diagrams to organize your work | ++------------------------+--------------------------------------------------------+ +| Description | Affinity diagrams help teams sort information gathered | +| | during research or brainstorming. Grouping similar | +| | concepts helps teams visualize and organize data. | ++------------------------+--------------------------------------------------------+ +| Author | Adobe Experience Cloud Team | ++------------------------+--------------------------------------------------------+ +| Publication Date | 04-26-2023 | ++------------------------+--------------------------------------------------------+ +| Category | Basics | ++------------------------+--------------------------------------------------------+ +| Tags | Data Foundation, Procurement & Operations | ++------------------------+--------------------------------------------------------+ +| Customer Journey Stage | Discover | ++------------------------+--------------------------------------------------------+ +| Product | Adobe Workfront | ++------------------------+--------------------------------------------------------+ +| Audience | Data Scientist , Operations/COO , Project Manager | ++------------------------+--------------------------------------------------------+ +| SEO-Article | Tier 2 | ++------------------------+--------------------------------------------------------+ + ++----------------------------------------------------------------------------------------------------------------+ +| Card Metadata | ++------------------+---------------------------------------------------------------------------------------------+ +| Title | How to use affinity diagrams to organize your work | ++------------------+---------------------------------------------------------------------------------------------+ +| CardDate | 2023-04-26 | ++------------------+---------------------------------------------------------------------------------------------+ +| CardImage | ![Co-workers in an office use affinity diagrams to organize their work. card image][image0] | ++------------------+---------------------------------------------------------------------------------------------+ +| CardImageAltText | Co-workers in an office use affinity diagrams to organize their work. card image | ++------------------+---------------------------------------------------------------------------------------------+ +| CardDescription | Affinity diagrams help teams sort information gathered during research or brainstorming. | +| | Grouping similar concepts helps teams visualize and organize data. | ++------------------+---------------------------------------------------------------------------------------------+ +| primaryTag | caas:content-type/blog | ++------------------+---------------------------------------------------------------------------------------------+ +| Tags | caas:content-type/blog, caas:cta/read-article | ++------------------+---------------------------------------------------------------------------------------------+ + ++---------------------------------------------+ +| Hide Block | ++-------+-------------------------------------+ +| Entry | /blog/basics/affinity-diagram-guide | ++-------+-------------------------------------+ +| Date | 2024-04-26 | ++-------+-------------------------------------+ + +[image0]: https://main--bacom-blog--adobecom.hlx.page/media_121eeacb954a3ffc093ca60775a5b12ab496a9c0a.png#width=2000&height=1000 + +[image1]: https://main--bacom-blog--adobecom.hlx.page/media_195a792ba321b4cb249495c411642a4aaedc1b2fb.png#width=2000&height=312 diff --git a/test/validation/mocks/md-mocks/updated/agile-daily-stand-up.md b/test/validation/mocks/md-mocks/updated/agile-daily-stand-up.md new file mode 100644 index 0000000..86c0ab6 --- /dev/null +++ b/test/validation/mocks/md-mocks/updated/agile-daily-stand-up.md @@ -0,0 +1,183 @@ +# Daily stand-ups for agile teams + +![Daily stand-ups for agile teams marquee][image0] + +Whether you’re just getting started with agile or you’re looking for ways to improve, optimizing your meeting time is one of the best places to start. Daily stand-ups are a key part of agile project management and a quick overview will help you optimize every sprint. + +This post will help you understand: + +- [What stand-ups are](https://business.adobe.com/blog/basics/agile-daily-stand-up#what-is-a-stand-up) +- [How to run them effectively](https://business.adobe.com/blog/basics/agile-daily-stand-up#how-to-run-an-effective-stand-up--a-basic-framework) +- [Common mistakes to avoid](https://business.adobe.com/blog/basics/agile-daily-stand-up#common-daily-stand-up-mistakes-to-avoid) +- [How to run stand-ups for distributed and remote teams](https://business.adobe.com/blog/basics/agile-daily-stand-up#how-to-run-stand-ups-for-distributed-and-remote-teams) +- [Additional tips and best practices for great stand-ups](https://business.adobe.com/blog/basics/agile-daily-stand-up#additional-tips-and-best-practices-for-effective-stand-ups) + +## What is a stand-up? + +**A stand-up meeting is a short daily meeting that allows team members to talk about immediate progress and challenges with their work.** Participants discuss important tasks, address issues, and hold one another accountable for regular goals. Because everyone is standing, the meeting is necessarily short — 15 minutes is best — to allow everyone to participate and stay on task. + +The guiding principle of agile project management is breaking down projects into smaller sets of tasks (or sprints). Daily stand-ups are a critical component of this method because it is the very best way to keep the team organized as they proceed through their sprints to the finished product. + +![The Complete Guide to Agile Marketing screenshot][image1] + +## How to run an effective stand-up — a basic framework + +Although there are probably as many ways to run a stand-up as there are people standing up, some guidelines can help you get the most out of the meeting. There are two basic types of stand-up meetings — one is more agile and one is based on [kanban](https://business.adobe.com/blog/basics/what-is-kanban) project management . + +### Agile stand-ups + +Agile stand-ups — sometimes called “round robins” — are 15-minute standing meetings where team members discuss their tasks for a particular project. These meetings center on individual team members and their work, including how they can improve. The purpose of the agile stand-up is to break down a project into manageable pieces and help each team member be accountable for those pieces. + +### The three agile stand-up questions + +Every agile stand-up meeting is built around three questions that each team member answers. + +1\. What did I accomplish yesterday? + +2\. What will I do today? + +3\. What obstacles, if any, are impeding my progress? + +These questions are the heart of the agile stand-up. They give each team member a chance to be heard, offer support to one another, and ask for help when they need it. A project can easily get bogged down without this accountability and structure. + +### Kanban stand-ups + +Sometimes called “walking the board,” kanban stand-ups are similar to agile stand-ups in that they are brief, focused, and designed to give team members accountability and structure. But a kanban stand-up is based on a visual representation of the workflow — called a kanban board. + +The function of kanban stand-ups is to find bottlenecks and address them before they derail any part of the project. The focus is less individual and more about the most important tasks at hand. Kanban meetings are all about efficiency and moving work through the board to completion. + +## Common daily stand-up mistakes to avoid + +To get the most out of your stand-up meeting, there are some common pitfalls to watch out for. Avoid these mistakes and set your team up for success. + +### Taking too long + +A well-run stand-up is fast. It touches the important points quickly and allows team members to get back to work. If your stand-up is taking longer than 15 minutes, it’s probably too long. + +If anyone is sitting down, for example, you’re not really holding a stand-up. Keeping everyone on their feet is one way to adhere to the time limit because people are more likely to ramble on if they’re seated in comfy chairs. + +### Letting it become a status report meeting + +This is where many stand-ups go wrong. Daily stand-up meetings should be peer-to-peer communication, not reporting-to-manager commentary. The goal of a stand-up is to keep the team aligned and on the same page. + +The difference is often in the vibe of the meeting. An alignment meeting is collaborative and team-focused, allowing team members to talk about what they’re doing and what they need. In contrast, a status report meeting is a top-down arrangement where a few people talk and everyone else listens. The latter makes team members feel like they’re being micromanaged, which is _not_ the goal. + +![Man and women leading a stand-up meeting][image2] + +### Not discussing blockers + +Sometimes an entire stand-up will go by and there will be no blockers or problems to discuss. But if there are _never_ any blockers to talk about, something’s not right. No project ever goes off flawlessly. + +If you’re not hearing about blockers during stand-ups, it’s possible that your team members don’t feel comfortable talking about their challenges or asking for help. In that case, it’s up to the team leaders to recognize this and help those people engage. + +### Skipping it + +Everyone is busy, and it can seem like a big sacrifice to set aside time to meet every single day. Busy people can also get overwhelmed and miss meetings — even when they don’t mean to. Then there are days when the team might feel that the project is going well and there’s no need for a stand-up. + +But skipping the daily stand-up is a bad idea. If the team opts not to meet, they lose an opportunity to touch base and identify where each member is with tasks. If the team is meeting and a few people don’t make it, the team will move ahead without those people — and that could have a serious effect on their work and productivity. + +### Not helping the introverts + +Introverts sometimes struggle in groups, and it’s even worse when you add a bit of public speaking. Even those team members who _aren’t_ introverts may have a hard time talking in front of others. The team leader should identify those who show signs of stress during meetings and find ways to help them speak up when they need to. This can be as simple as providing some guidance on how to prepare ahead of time so they’re more confident. + +### Losing focus + +Agile stand-ups should be concise and everything discussed during the meeting should be relevant to the entire team. Long recitations, social interactions, or updates that don’t apply to everyone are inappropriate for a stand-up. + +Getting caught up in problem-solving is another common way that teams lose focus during a stand-up. There is a time and place for that, but the stand-up meeting is not it. + +## How to run stand-ups for distributed and remote teams + +You can hold effective stand-ups even if your team is spread out. With the remote connection options available now, you don’t have to be in the same time zone to have a stand-up meeting. + +There are a few ground rules for hosting a remote stand-up. + +- **Everyone is on their own computer.** When some team members are standing together and others are watching remotely, the in-person team tends to own the conversation. To keep your remote members from feeling isolated, level the playing field by putting everyone in front of their own screen. +- **Participants should view the meeting using a grid layout.** Your team members will feel equally valued and seen when all their faces are visible. +- **The meeting host should share the board.** If you’re using a kanban board or other visual, share it on the screen. Everyone looking at the board together fosters the sense of collaboration that is vital for an agile stand-up. + +\ +\ +Of course, when time zones don’t match up well, getting everyone on their computer at the same time can be difficult. That’s why asynchronous stand-ups are becoming more and more popular. In this format, daily meetings are replaced by written communication using a common platform that everyone on the team can access.\ +\ +Team members should be asked to answer the three agile stand-up questions in writing by a certain time — giving each member the freedom to do it when they can. + +![Additional tips and best practices graphic][image3] + +## Additional tips and best practices for effective stand-ups + +If you’re devoting time every day to a stand-up, you want that time to be productive. The best way to guarantee it’s not a waste of time is to adhere to a few basic best practices. + +1. **Hold your stand-up at the same time every day and at a time that works well for everyone.** Mornings are often best, but it’s not a requirement. It’s more important to ensure the meeting doesn’t interrupt workflow, so use that as your guiding scheduling principle. +2. **Keep your team engaged.** People can zone out even in a short meeting. First, ask team members to put their phones away during the stand-up. Then, find ways to keep people attentive that don't interrupt the conversation. You may try tossing a ball around the group during the meeting to keep people alert. Passing around a snack is another good way to keep people’s attention focused while not disrupting the conversation. +3. **Keep the team small.** If your team is too big, your meeting will be too long. It’s best to keep it to no more than 10 people — and fewer is better. If you have a large team, divide it half and have separate meetings. +4. **Stick to the schedule and use alarms.** Set one alarm for five minutes before the meeting to ensure no one is late, and set one for the end to guarantee a timely wrap-up. The alarm can be anything that gets the attention of your team — a pop-up on the calendar, a bell in the office, a song, or a gif or meme in the team chat. The options are endless. + +## Getting started with stand-up meetings + +Daily stand-ups are a key part of agile project management — and if they’re run well, they can improve the productivity and efficiency of your team. + +Start by explaining the concept to your team — including how it will work and why it’s important. Ask for their suggestions on the best time to schedule them and set up reminders for the start and end of each day’s stand-up. + +You may find that the software your team is using is holding back your agile project management style. [Adobe Workfront](https://www.workfront.com/products?ef_id=CjwKCAjwt7SWBhAnEiwAx8ZLanwVpwWWfg3sBPmqeKQ_ckwge7on8BLjXECwyLQOnLNhRnuSKZoJ0RoCeSwQAvD_BwE:G:s\&s_kwcid=AL!3085!3!517409436165!e!!g!!what%20is%20adobe%20workfront!10503449184!106943433994\&o=7010z000000ymxNAAQ\&utm_source=google\&utm_medium=cpc\&keyword=what%20is%20adobe%20workfront\&ad=517409436165\&matchtype=e\&device=c\&utm_campaign=us_brand_wf\&s_kwcid=AL!6440!3!517409436165!e!!g!!what%20is%20adobe%20workfront\&strala_id=ga-1-517409436165-106943433994\&strala_kw=what%20is%20adobe%20workfront\&strala_mt=e\&strala_dv=c\&strala_pl=\&strala_nw=g\&strala_ap=\&gclid=CjwKCAjwt7SWBhAnEiwAx8ZLanwVpwWWfg3sBPmqeKQ_ckwge7on8BLjXECwyLQOnLNhRnuSKZoJ0RoCeSwQAvD_BwE) is designed to help teams stay agile with features that streamline workflow and enhance the way you get things done. + +**_Take a free [product tour](https://www.workfront.com/tours/workfront) to see how Workfront can optimize your process._** + ++----------------------------------------------------------------------------------+ +| Metadata | ++------------------------+---------------------------------------------------------+ +| Title | Daily stand-ups for agile teams | ++------------------------+---------------------------------------------------------+ +| Description | A stand-up meeting is a short daily meeting that allows | +| | team members to talk about immediate progress and | +| | challenges with their work. | ++------------------------+---------------------------------------------------------+ +| Author | Adobe Communications Team | ++------------------------+---------------------------------------------------------+ +| Publication Date | 08-18-2022 | ++------------------------+---------------------------------------------------------+ +| Category | Basics | ++------------------------+---------------------------------------------------------+ +| Tags | Project Manager, Adobe Workfront | ++------------------------+---------------------------------------------------------+ +| Customer Journey Stage | Evaluate | ++------------------------+---------------------------------------------------------+ +| SEOArticle | Tier 1 | ++------------------------+---------------------------------------------------------+ + ++----------------------------------------------------------------------------+ +| Card Metadata | ++------------------+---------------------------------------------------------+ +| Title | Daily stand-ups for agile teams | ++------------------+---------------------------------------------------------+ +| CardDate | 2022-08-18 | ++------------------+---------------------------------------------------------+ +| CardImage | ![Daily stand-ups for agile teams card image][image0] | ++------------------+---------------------------------------------------------+ +| CardImageAltText | Daily stand-ups for agile teams card image | ++------------------+---------------------------------------------------------+ +| CardDescription | A stand-up meeting is a short daily meeting that allows | +| | team members to talk about immediate progress and | +| | challenges with their work. | ++------------------+---------------------------------------------------------+ +| primaryTag | caas:content-type/blog | ++------------------+---------------------------------------------------------+ +| Tags | caas:content-type/blog, caas:cta/read-article, | +| | caas:products/workfront | ++------------------+---------------------------------------------------------+ + ++-------------------------------------------+ +| Hide Block | ++-------+-----------------------------------+ +| Entry | /blog/basics/agile-daily-stand-up | ++-------+-----------------------------------+ +| Date | 2024-04-26 | ++-------+-----------------------------------+ + +[image0]: https://main--bacom-blog--adobecom.hlx.page/media_10fb74f49e8af2116c2f516f5d5d61da33b304f05.png#width=2000&height=1000 + +[image1]: https://main--bacom-blog--adobecom.hlx.page/media_1514bf0c4f62b0bf896acd7c383b30442de267fef.png#width=2000&height=946 + +[image2]: https://main--bacom-blog--adobecom.hlx.page/media_1ad59421d12e0c7315aa0223798712abff2a0a8fa.png#width=2000&height=1010 + +[image3]: https://main--bacom-blog--adobecom.hlx.page/media_10d25fd1eeb59aaa04c47af0779a7ee1e1c96b6f3.png#width=2000&height=655 diff --git a/test/validation/mocks/md-mocks/updated/agile-development.md b/test/validation/mocks/md-mocks/updated/agile-development.md new file mode 100644 index 0000000..2d9a208 --- /dev/null +++ b/test/validation/mocks/md-mocks/updated/agile-development.md @@ -0,0 +1,114 @@ +# Agile Development + +![agile developer in front of desktop][image0] + +Agile is a highly flexible approach to software development, tailored to the needs of modern teams. It facilitates an iterative method, highlighting continuous improvement to meet high-quality client deliverables collaboratively. In this article, learn how Agile development enables teams to deliver new products, features, and functionality more nimbly, and why it's an effective option for many development teams in fast-paced fields. + +[Take the product tour](https://www.workfront.com/tours/workfront) + +## What is Agile development? + +Agile development was born out of frustration with unreasonable delays seen with more traditional development practices, such as [Waterfall](https://www.workfront.com/project-management/methodologies/waterfall). This revolutionary approach to software development emphasizes continuous, incremental improvement and responsiveness to user needs, rather than highly planned, staggered product launches or updates. And although not limited to software, Agile has been particularly effective in this field, leading to more industries adopting this methodology to improve quality due to continuous collaboration with clients. + +From a practical perspective, Agile development allows teams to respond to client needs, implement constant feedback, and deliver higher-quality work. + +To illustrate the benefits of [Agile methodology](https://marketo.com/project-management/methodologies/agile) more fully, here is how it compares to the Waterfall method: + +### [Agile vs. Waterfall: Key contrasts.](https://www.workfront.com/project-management/methodologies/agile/agile-vs-waterfall) + +- **[Flexible planning vs. rigid approach](https://www.workfront.com/project-management/methodologies/agile/agile-vs-waterfall)**: Agile’s flexible planning approach accounts for constant client changes. Waterfall’s planning is comprehensive but not adaptive to change. Agile planning leads to rapid results, whereas Waterfall’s planning delays outcomes. +- **Constant testing vs. final product testing**: Agile development teams constantly test the product to make sure its characteristics meet client demands. Waterfall development teams only test the product once finalized, making changes close to impossible. +- **Continuous delivery vs. end-of-project deliverables**: Frequent delivery by Agile development teams enables enhancements as the project progresses. On the other hand, Waterfall development teams only deliver once the project is complete, leaving no room for product improvements. + +Learn more about the [differences between Agile and Waterfall](https://www.workfront.com/project-management/methodologies/agile/agile-vs-waterfall). + +## Agile development: Essential concepts. + +The [Agile Manifesto](https://www.workfront.com/project-management/methodologies/agile/agile-manifesto) comprises 12 overarching software development principles. Many of these principles focus on exceeding customer expectations through collaboration and [enhancing quality](https://www.workfront.com/project-management/knowledge-areas/quality-management) via continuous communication and deliverables. Below are essential Agile development concepts. + +### Accommodating changing requirements. + +Agile development highlights the value of meeting changing client needs as these take place. Should the client want an app addition or software improvement not discussed in the original plans, the Agile development team would embrace change after thorough discussion. Agile software development methods [adapt to project dynamics](https://www.workfront.com/resources/unlock-the-promise-of-agile-in-the-enterprise) as opposed to traditional methodologies that remain static. + +### Delivering working software. + +Software development teams using the Agile methodology tend to deliver working software by the time the project comes to an end. In contrast, the Waterfall method delivers software at the end of the project deadline, which may still require changes to operate as intended due to high concentrations of documentation. + +This difference means that keeping a constant eye on incremental changes and improvements in the Agile methodology is typically superior to Waterfall because of intense collaboration between cross-functional teams and clients. Although the Agile method may produce greater value than the Waterfall approach, some development teams may prefer to [combine them](https://www.workfront.com/resources/solve-the-pain-of-mixing-agile-and-waterfall) to adapt to organizational needs. + +### Continuously integrating user feedback and needs. + +Agile development teams actively place client needs before contract requirements. The consequence of this people-first approach is that teams listen and hear what their clients are saying. Feedback is taken seriously and integrated into projects to produce superior outcomes instead of strict adherence to original plans, which are not as [responsive to change](https://www.workfront.com/resources/20-experts-share-secrets-for-balancing-agile-and-waterfall). + +### Making an MVP. + +Building a minimum viable product (MVP) is a core concept of Agile development. Produce the product within certain parameters—such as its requirements, design, development, testing, and delivery—and learn from the real-time experience of how customers interact with the outcome. Following an iterative process of feedback and improvements requires ongoing learning that consequently leads to improved quality. Agile can formulate the MVP because the risks of introducing the market to new products are better managed. + +### Assessing opportunities for improvement. + +Agile development teams are notable for their drive to search for ways to make improvements. Instead of waiting for opportunities to come to them, software development teams actively look for ways to improve their products. Meetings, [scope management](https://marketo.com/project-management/knowledge-areas/scope-management), communication, benchmarking, and feedback are just some methods to assess opportunities for improvement on the path to delivering high-quality products. + +## Agile development approaches: Methodologies and practices. + +The Agile philosophy has continued to evolve since its inception in the early 2000s. In fact, it has blossomed into several distinct approaches and techniques that draw on Agile’s basic principles. + +[Four of these methodologies](https://www.workfront.com/project-management/methodologies) include: + +- **[Scrum](https://www.workfront.com/project-management/methodologies/scrum):** Scrum embraces the concept of sprints, which refer to tasks that teams need to complete in realistic time frames. Daily meetings guide the completion of each task in which teams share feedback on progress, obstacles experienced, and the plan to overcome those obstacles. A retrospective meeting ends each sprint to discuss progress and productivity. +- **[Kanban](https://www.workfront.com/project-management/methodologies/kanban):** Kanban highlights workflow optimization compared to other methodologies that concentrate on the cyclical nature of project processes. A Kanban visualization board helps team members imagine how their workflow can be improved within achievable work parameters for a stated period rather than taking on large workloads that are unachievable. During the visualization process, team members evaluate the workflow to determine where and how they can implement ongoing improvements. +- **Extreme programming (XP):** Team members produce software deliverables often with this methodology based on the concept that brief work cycles enhance productivity. This approach relies on frequent feedback to make improvements based on change requests rather than restricting work to the original scope definition. +- **Agile/Waterfall hybrid:** Traditional approaches like Waterfall still have their place in modern software development and project management. The difference is that software can facilitate a hybrid of frameworks to extract the best from each while limiting their respective shortfalls. + +## Adopting Agile: Beginning a new development approach. + +Agile software development is an effective way to manage projects that exhibit quality processes and performance. Flexible planning, testing, and team/client collaboration ensure that any enterprise can unlock its potential and produce successful outcomes. Organizations can benefit from using the Agile methodology to take software project development beyond what they previously envisioned. + +**To learn more about Audience Activation, check out our [documentation](https://experienceleague.adobe.com/docs/commerce-admin/customers/customers-menu/audience-activation.html?lang=en). Then visit the Marketplace to download the [extension](https://marketplace.magento.com/magento-audiences.html), exclusively for Commerce and Real-Time CDP customers. If you want to know more about brand-new personalization features in Commerce and see a demo of Audience Activation,** **[watch _Personalizing the Commerce Experience_ from Adobe Summit](https://business.adobe.com/summit/2023/sessions/personalizing-the-commerce-experience-s508.html)** **.** + ++------------------+----------------------------------------------------------+ +| Metadata | | ++==================+==========================================================+ +| Title | What is Agile Software Development? \| Adobe Workfront | ++------------------+----------------------------------------------------------+ +| Description | Learn how Agile can drive software development projects | +| | to produce high-performance deliverables. | ++------------------+----------------------------------------------------------+ +| Category | basics | ++------------------+----------------------------------------------------------+ +| Publication Date | 03-18-2022 | ++------------------+----------------------------------------------------------+ +| Author | Adobe Communications Team | ++------------------+----------------------------------------------------------+ +| Tags | Adobe Experience Cloud, Project Manager, Operations/COO, | +| | Marketing Executive, | ++------------------+----------------------------------------------------------+ + ++------------------------------------------------------------------------------+ +| Card Metadata | ++------------------+-----------------------------------------------------------+ +| Title | Agile Development | ++------------------+-----------------------------------------------------------+ +| CardDate | 2022-03-18 | ++------------------+-----------------------------------------------------------+ +| CardImage | ![agile developer in front of desktop card image][image0] | ++------------------+-----------------------------------------------------------+ +| CardImageAltText | agile developer in front of desktop card image | ++------------------+-----------------------------------------------------------+ +| CardDescription | Learn how Agile can drive software development projects | +| | to produce high-performance deliverables. | ++------------------+-----------------------------------------------------------+ +| primaryTag | caas:content-type/blog | ++------------------+-----------------------------------------------------------+ +| Tags | caas:content-type/blog, caas:cta/read-article, | +| | caas:business-unit/experience-cloud | ++------------------+-----------------------------------------------------------+ + ++----------------------------------------+ +| Hide Block | ++-------+--------------------------------+ +| Entry | /blog/basics/agile-development | ++-------+--------------------------------+ +| Date | 2024-04-26 | ++-------+--------------------------------+ + +[image0]: https://main--bacom-blog--adobecom.hlx.page/media_13e7062e80919a8e8b3d369f7fefb30dfe8278126.jpeg#width=626&height=351 diff --git a/validation/README.md b/validation/README.md new file mode 100644 index 0000000..146a272 --- /dev/null +++ b/validation/README.md @@ -0,0 +1,21 @@ +# Post Bulk Update Link Validation + +Validation tool to test the integrity of links pre and post bulk update and user preview. + +The tool takes the list of paths provided asnd uses it to check the source and updated md +folders that should contain md files pulled down from query-log.json files. + +The validator differs from the link validation done during bulk updating by checking two different +folders that should be representative of md files from different stages of the bulk update process. +To ensure link integraty, the "updated" md folder should contain MDs that are either post update, post +Sharepoint opened, or both. + +## Usage + +Run the migration script directly, ensuring to set the path: + +```bash +node validation/link-validator.js {path to list.json} {path to md directory} + +example: node validation/link-validator.js ./blog-test/output/list.json ./blog-test/md +``` diff --git a/validation/link-validator.js b/validation/link-validator.js new file mode 100644 index 0000000..2d2f76c --- /dev/null +++ b/validation/link-validator.js @@ -0,0 +1,174 @@ +/* eslint-disable no-continue */ +import fs from 'fs'; +import { selectAll } from 'unist-util-select'; +import { ExcelReporter, loadListData } from '../bulk-update/index.js'; +import { getMdast } from '../bulk-update/document-manager/document-manager.js'; + +export const LINKS_MATCH = 'all links match'; +export const LINKS_DO_NOT_MATCH = 'links mismatch mapping'; +export const LENGTHS_DO_NOT_MATCH = 'source and updated list do not have the same length'; + +/** + * + * @param {mdast} sourceMd + * @param {mdast} updatedMd + * @returns {Object} an object with mdast collections of links from both files + */ +export function getLinksLists(sourceMdast, updatedMdast) { + return { + sourceLinks: selectAll('link', sourceMdast), + updatedLinks: selectAll('link', updatedMdast), + }; +} + +/** + * Checks the source and update link lists and compares to find the differences + * + * @param {list of mdast link nodes} sourceLinks + * @param {list of mdast link nodes} updateLinks + * @param {path to the file} entry + * @returns Log messages for the reporter based on findings + */ +export function deepCompare(sourceLinks, updateLinks, path) { + console.log(`Deep comparing links on source and updated files at this path: ${path}`); + const linkLog = {}; + + sourceLinks.forEach((link, index) => { + const updateLink = updateLinks[index]; + + let sourceUrl; + let updateUrl; + try { + sourceUrl = new URL(link.url); + } catch (e) { + sourceUrl = false; + linkLog[`relative-source-link-${index}`] = link.url; + linkLog[`relative-source-text-${index}`] = link?.children[0].value; + } + try { + updateUrl = new URL(updateLink.url); + } catch (e) { + updateUrl = false; + linkLog[`relative-update-link-${index}`] = link.url; + linkLog[`relative-update-text-${index}`] = link?.children[0].value; + } + + // Partial matches are not fully qualified urls + if (!sourceUrl || !updateUrl) { + linkLog[`partialUrlMatch-${index}`] = link.url === updateLink.url; + } + + linkLog[`sourceLink-${index}`] = link.url; + linkLog[`updatedLink-${index}`] = link.children[0].value; + linkLog[`sourceText-${index}`] = updateLinks[index].url; + linkLog[`updatedText-${index}`] = updateLinks[index]?.children[0]?.value; + linkLog[`linksMatch-${index}`] = link.url === updateLink.url; + linkLog[`hashMatch-${index}`] = sourceUrl ? sourceUrl.hash === updateUrl.hash : ''; + linkLog[`hostMatch-${index}`] = sourceUrl ? sourceUrl.host === updateUrl.host : ''; + linkLog[`pathMatch-${index}`] = sourceUrl ? sourceUrl.pathname === updateUrl.pathname : ''; + linkLog[`searchMatch-${index}`] = sourceUrl ? sourceUrl.search === updateUrl.search : ''; + linkLog[`textMatch-${index}`] = link?.children[0]?.value === updateLink?.children[0]?.value; + }); + + return ['Deep Compare Links', LINKS_DO_NOT_MATCH, path, { log: linkLog }]; +} + +/** + * Does an initial check for link matching, if it finds issue, it runs the deepCompare function + * + * @param {list of source links} sourceLinks + * @param {list of updated links} updatedLinks + * @param {path to files} path + * @returns Returns a message for reporter + */ +export function compareLinkLists(sourceLinks, updatedLinks, path) { + console.log(`Comparing source and update files at this path: ${path}`); + // If not the same length, something is wrong from the start + if (sourceLinks.length !== updatedLinks.length) { + return ['Compare Links', 'list length', LENGTHS_DO_NOT_MATCH]; + } + + const linksMatch = !sourceLinks.map((link, i) => { + const updated = updatedLinks[i]; + return link.url === updated.url + && link.children[0]?.value === updated.children[0]?.value; + }).includes(false); + + if (!linksMatch) { + return deepCompare(sourceLinks, updatedLinks, path); + } + + return ['Compare Links', LINKS_MATCH, path]; +} + +/** + * Runs the primary migration and returns a message for reporter. + * Additional logic for code failing conditions + * + * @param {list of paths} list + * @param {path to md files} mdPath + * @param {ExcelReporter} reporter + */ +export async function validateMigratedPageLinks(list, mdPath, reporter) { + const listData = await loadListData(list); + const source = '/source'; + const updated = '/updated'; + + for (const path of listData) { + const pathToSourceMd = path.endsWith('/') ? `${mdPath}${source}${path}index.md` : `${mdPath}${source}${path}.md`; + const pathToUpdateMd = path.endsWith('/') ? `${mdPath}${updated}${path}index.md` : `${mdPath}${updated}${path}.md`; + + let sourceMd; + let updatedMd; + try { + sourceMd = fs.readFileSync(pathToSourceMd, 'utf-8'); + } catch (e) { + console.log(`File does not exist at provided path: ${pathToSourceMd}`); + reporter.log('Error', 'File does not exist at provided path:', pathToSourceMd); + continue; + } + try { + updatedMd = fs.readFileSync(pathToUpdateMd, 'utf-8'); + } catch (e) { + console.log(`File does not exist at provided path: ${pathToUpdateMd}`); + reporter.log('Error', 'File does not exist at provided path', pathToUpdateMd); + continue; + } + + const sourceMdast = await getMdast(sourceMd); + const updatedMdast = await getMdast(updatedMd); + const { sourceLinks, updatedLinks } = await getLinksLists(sourceMdast, updatedMdast); + const message = compareLinkLists(sourceLinks, updatedLinks, path); + + reporter.log(message[0], message[1], message[2], message[3]?.log); + } +} + +/** + * Set up reporter and save + * + * @param {list of paths} listPath + * @param {path to md files} mdPath + */ +export async function main(listPath, mdPath) { + const { pathname } = new URL('.', import.meta.url); + const dateString = ExcelReporter.getDateString(); + const myReporter = new ExcelReporter(`${pathname}output/validation-${dateString}.xlsx`, false); + + await validateMigratedPageLinks(listPath, mdPath, myReporter); + myReporter.generateTotals(); + myReporter.saveReport(); +} + +export async function init(list, mdPath) { + await main(list, mdPath); +} + +// test values ./blog-test/output/list.json', './blog-test/md' +if (import.meta.url === `file://${process.argv[1]}`) { + const args = process.argv.slice(2); + const [list, mdPath] = args; + + await init(list, mdPath); + process.exit(0); +}