File: content/manuals/accounts/company/manage.md
Issue
The documentation contains contradictory statements about whether organizations can be removed from a company:
First statement (under "Add more organizations"):
Once you add an organization to a company, you can't remove it from the company.
Second statement (immediately following):
A nested organization must keep its Docker Business subscription to stay managed by the company. If an organization downgrades from Docker Business, you can no longer manage it through the company, and its owner must manage it separately.
Why this matters
A reader trying to understand company management would be confused about whether organizations can leave a company. The first statement says removal is impossible, but the second describes a scenario where an organization effectively leaves the company (through downgrading). This leaves readers uncertain about:
- What happens to an organization that downgrades - is it still "in" the company but unmanageable, or is it removed?
- Whether there are any ways to remove an organization besides downgrading
- What "can't remove it" actually means in practice
Suggested fix
Clarify the relationship between these two statements. Options:
-
If downgrading removes the organization from the company, update the first statement to: "Once you add an organization to a company, you can't manually remove it. However, if the organization downgrades from Docker Business, it will be automatically removed from the company."
-
If downgrading doesn't remove the organization but just makes it unmanageable, clarify: "Once you add an organization to a company, you can't remove it from the company. However, if an organization downgrades from Docker Business, it remains in the company but can no longer be managed through the company portal."
The correct fix depends on the actual product behavior.
Found by nightly documentation quality scanner
File:
content/manuals/accounts/company/manage.mdIssue
The documentation contains contradictory statements about whether organizations can be removed from a company:
First statement (under "Add more organizations"):
Second statement (immediately following):
Why this matters
A reader trying to understand company management would be confused about whether organizations can leave a company. The first statement says removal is impossible, but the second describes a scenario where an organization effectively leaves the company (through downgrading). This leaves readers uncertain about:
Suggested fix
Clarify the relationship between these two statements. Options:
If downgrading removes the organization from the company, update the first statement to: "Once you add an organization to a company, you can't manually remove it. However, if the organization downgrades from Docker Business, it will be automatically removed from the company."
If downgrading doesn't remove the organization but just makes it unmanageable, clarify: "Once you add an organization to a company, you can't remove it from the company. However, if an organization downgrades from Docker Business, it remains in the company but can no longer be managed through the company portal."
The correct fix depends on the actual product behavior.
Found by nightly documentation quality scanner