Issue in help/using/understand-your-test-results.md
Need to add documentation around SonarQube concepts from this - https://docs.sonarqube.org/7.4/user-guide/concepts/
Suggestion from Justin Edelson after posing the question from a customer.

Issue in help/using/manage-your-environment.md

Just in case the customer wants to set up their own development environment on premise, it should be interesting to include the OS used in Managed Services, to configure the DEV env as close as possible to PRE-PROD.

Thank you.

Issue in help/using/notifications.md
It looks like the experience cloud manager preferences page UI for setting up email notification has been changed significantly and that's not reflected in the Cloud Manager docs:

https://docs.adobe.com/content/help/en/experience-manager-cloud-manager/using/how-to-use/notifications.html

[submitted by support]

Issue in ./help/using/configuring-pipeline.md

In light of recent movements (e.g. Black Lives Matter) that impacted the use of certain technical terms such as master, consideration should be given to updating the documentation screenshot below to avoid negative connotations.

Issue in ./help/using/content-copy.md

[Redacted]

Could you please take some time in the next few days to make changes to some terminology in your repos and content as much as is possible:

• Whitelist/blacklist to Allowed List and Blocked List (or Approve List/Deny List - some software uses this instead) respectively. Google and many developers are formalizing allowlist and blocklist. You might want to lobby for those terms to be used in the UI.
• Master/Slave to master and replica (or subordinate, if that makes more sense) respectively.

If you cannot remove the term because the writing for example reflects the UI or the code, please make a note and send me an email to [email protected] so we can bring it that team’s attention. Thanks for your efforts in this matter.

Issue in ./help/using/notifications.md

Don't know how to control the email notifications separate from the status bar notifications.

Issue in help/using/configure-your-release-branches.md

The "Git Cheat Sheet" link is broken.
Maybe the correct URL is: https://github.github.com/training-kit/downloads/github-git-cheat-sheet.pdf

Please verify and correct the link. Thanks

Ignore this issue

Issue in help/using/introduction-to-cloud-manager.md

Issue in help/using/custom-code-quality-rules.md

"Cloud Service Compatibility" is not defined, nor even mentioned, on this document. This is the destination doc page for https://docs.adobe.com/content/help/en/experience-manager-cloud-manager/using/how-to-use/understand-your-test-results.html which has the note:

"To learn more about the custom code quality rules executed by Cloud Manager, please refer to Custom Code Quality Rules ."

which leads to this page but "Cloud Service Compatibility" is not here.

Issue in help/using/configuring-pipeline.md

From reading the section "Dispatcher Invalidation" it is not clear whether it is flushed/invalidated via ReST request via https://docs.adobe.com/content/help/en/experience-manager-dispatcher/using/configuring/page-invalidate.html#delete-cached-files or it is directly acting on the filesystem. Related to that do the paths refer to filesystem paths or repository paths?
How to remove stuff from the author dispatcher cache?
Which host is being used for the ReST request (if those are used). Is it the "flush" host?

Issue in ./help/using/configuring-pipeline.md

Issue in ./help/managing-code/repositories.md
The following note should be added to the documentation:

When a repository is deleted in cloud manager, it is only soft deleted, meaning it is kept, but marked as deleted for recovery purposes. If the user tries to recreate one with the same name, the user will get an error saying "An error has occurred while trying to create repository. Please contact your CSE or Adobe Support." If this error is received, please log a ticket with support so that the cloud manager team can rename the archived project, or use a different name.

Label: DocBugBlitz2023

Issue in ./help/requirements/role-based-permissions.md

Other documentation pages where AEM/AMS and AEM/CS have differences have a link to the according other page. In this case

https://experienceleague.adobe.com/docs/experience-manager-cloud-manager/content/requirements/role-based-permissions.html?lang=en

and

https://experienceleague.adobe.com/docs/experience-manager-cloud-service/content/onboarding/concepts/cloud-manager-introduction.html

could be interlinked.

The issue is.. whenever I google for "Cloud Manager Permissions" I'll end up on this page .. and the other is nowhere to be found..

Issue in ./help/using/build-environment-details.md

In the Cloud Manager build we would like to use the commit id (to include it in the bundle and package description). In Jenkins this is provided via environment variables exposed by the Git Plugin (https://plugins.jenkins.io/git/#commit-variables). Is there an environment variable provided in the Cloud Manager build pipeline or do I have to leverage a dedicated plugin like https://github.com/git-commit-id/git-commit-id-maven-plugin?

The spreadsheet is present in github at https://github.com/AdobeDocs/experience-manager-cloud-manager.en/blob/master/help/using/assets/sonarqube-rules.xlsx

Issue in ./help/using/setting-up-program.md

With the release 2021.06 customers have the option to edit the name of program via CM UI, see Shankari release email
"Cloud Service customers can now edit the Program name after it has been created by using the Edit Program workflow"

Also https://jira.corp.adobe.com/browse/CMGR-16969

In the documentation page, there is no mention of this feature, and the screenshot in the "Editing a program" section shows the program name as disabled
Could this screenshot amended and the information about the name modification being possible added?

[Logged by Support]

Issue in ./help/using/deploying-code.md

Recently learned that the dispatcher cache is not flushed on non production deployment and should be taken care manually either by ssh access or re-replicating pages. Though it would make sense to completely wipe out cache on non production environments, it should be called out in the documentation if not possible for any reason.

Issue in help/using/create-an-application-project.md
It just states

When the Cloud Manager build process starts, the element in this file will be merged into the default settings.xml file provided by Cloud Manager

It is crucial to know which server ids are already taken by the default settings.xml and whether certain ids are processed via a mirror.

Issue in ./help/requirements/users-and-roles.md
The document says:
You can create or add users/groups to these product profiles with the Admin Console.
Log in to the Admin Console and click New Profile to add a new profile.

When I go to adminconsole.adobe.com, I don't see a "New Profile" link/button. I have no idea how to get to the page shown in the doc.

Within our projects a typical step is a sonar scan before pushing code into an adobe git. Right now we use standard Sonar rules but not the ones specific for AEM. We would like to reuse the ones which Cloud manager uses: https://experienceleague.adobe.com/docs/experience-manager-cloud-manager/content/using/custom-code-quality-rules.html?lang=en

Could you please export the rules so we can integrate them within our own sonarqube?

As follow up to #40 which has been closed without explanation.
I still don't see an environment variable which exposes the git commit in https://experienceleague.adobe.com/docs/experience-manager-cloud-manager/content/getting-started/project-creation/build-environment.html?lang=en#environment-variables. Please clarify why #40 has been closed and what has been fixed actually.

I see lot of broken links on
https://experienceleague.adobe.com/docs/experience-cloud-kcs/kbarticles/KA-17457.html?lang=en
specially any text with [this article]

https://experienceleague.adobe.com/docs/experience-manager-cloud-manager/using/how-to-use/pipelines/configuring-production-pipelines.html?lang=en

Incorrect in public docs:
Flush - Perform a cache invalidation, similar to when content is activated from an authoring instance to a publishing instance.
Invalidate - Performs a cache deletion.

What it should be:
Flush - Performs a cache deletion.
Invalidate - Perform a cache invalidation, similar to when content is activated from an authoring instance to a publishing instance.

Issue in help/using/introduction-to-cloud-manager.md

The first line of Intro page from CM public documentation (https://experienceleague.adobe.com/docs/experience-manager-cloud-manager/using/introduction-to-cloud-manager.html?lang=en#introduction-to-cloud-manager) states:
"Cloud Manager, part of the Adobe Managed Services"

The sentence should be changed to reflect the updated business ownership of CM product.

Issue in help/using/custom-code-quality-rules.md

Customer asked about this particular item "CQRules:CQBP-75":
Q: Why change?
A: It's a security consideration. The advantage of using nodes in the JCR over paths is that you can easily control access to nodes via ACLs. If it's done outside of the JCR then the customer needs to handle the security themselves.

Issue in help/using/dispatcher-configurations.md

It looks correct in the Markdown, but when rendered on https://docs.adobe.com/content/help/en/experience-manager-cloud-manager/using/getting-started/dispatcher-configurations.html it is all one word:

It would be a good feature to subscribe to CM release notes via RSS.

Issue in ./help/using/first-time-login.md

The new video introducing programs appears to be centred around Cloud Service, which gives the impression that it is a button-click away from creating a new Program. However, in AMS the Program is not tied just to a logical infrastructure but in-effect a physical infrastructure. Could we attempt to enhance the clarity here? It creates an idea that the number of Programs on AMS is elastic which is not strictly the case. Thank you.

Update "Environment Variable" info on this page with a note.

Update with a note and links referring how to configure the https://github.com/adobe/aio-cli-plugin-cloudmanager to set pipeline variables.

Docs for api integration:
https://www.adobe.io/apis/experiencecloud/cloud-manager/docs.html#!AdobeDocs/cloudmanager-api-docs/master/create-api-integration.md
https://www.adobe.io/apis/experiencecloud/cloud-manager/docs.html#!AdobeDocs/cloudmanager-api-docs/master/permissions.md

I would like to have the content on this page migrated to the official docs and start a new FAQ page for Cloud Manager:
https://helpx.adobe.com/experience-manager/kb/cm/cm-faq.html

Issue in help/using/activating-maven-project.md

https://docs.adobe.com/content/help/en/experience-manager-cloud-manager/using/managing-code/activating-maven-project.html

Issue in ./help/getting-started/first-time-login.md
Can you add a link for this:
Log in to Adobe Experience Cloud and you see the list of programs.

So the user knows how to access "Adobe Experience Cloud".

Label: DocBugBlitz2023

Issue in help/using/setting-up-project.md

As it is now possible to add custom repositories to the merged settings.xml it is sometimes important to know if the custom repository is added as first or last choice (after server ids adobe, cloud-manager and central or before them).
In most of the cases the custom repository should be tried last (as no other repo should have the artifact with the same coordinates) but for some edge cases you might also want to overwrite an artifact also available with the same GAV in another repo.

Issue in help/using/setting-up-users-and-roles.md

This doc just mentions about adding Profiles & Users for Cloud Manager.

Please include a Note in this doc, that states that adding a User or a Profile to the author environment won't create/setup the same user/profile for publish environment.
Separate users/profiles will have to be setup/created for publish environments, depending upon the use case.

[Logged by AEM Support]