MicrosoftDocs / azure-docs

Open source documentation of Microsoft Azure
https://docs.microsoft.com/azure
Creative Commons Attribution 4.0 International
10.11k stars 21.17k forks source link

Clarify/improve wording 'a copy of the VHDs in the image are used to create the disks' #122494

Closed sabuncumurat closed 1 month ago

sabuncumurat commented 1 month ago

1) First paragraph says:

When you create a VM from the image, a copy of the VHDs in the image are used to create the disks for the new VM.

I believe the wording could be improved, as it's not clear if one copy is being used to create multiple disks. I suggest:

When you create a VM from the image, copies of the VHDs in the image are used to create the disks for the new VM.

However, the above may still be incorrect (referencing plural disks), if the image may contain a single disk.

2) Before the first table, it says:

When you use a gallery to store images, multiple resource types are created:

The first resource given in the table, the VM, must have already been created for the image create process to proceed in the first place. Therefore, I suggest the following improved wording:

When you use a gallery to store images, multiple resource types are used:

Maybe also clarify the table to indicate that the VM resource must already exist, and that the other resources are derived from the VM.

FYI.


Document Details

Do not edit this section. It is required for learn.microsoft.com ➟ GitHub issue linking.

TPavanBalaji commented 1 month ago

@sabuncumurat Thanks for your feedback! We will investigate and update as appropriate.

TPavanBalaji commented 1 month ago

@sabuncumurat Thanks for reporting this! We have created a PR for this issue and the changes should go live soon.

TPavanBalaji commented 1 month ago

@sabuncumurat We are going to close this thread as resolved but if there are any further questions regarding the documentation, please tag me in your reply and we will be happy to continue the conversation.

sabuncumurat commented 1 month ago

Thank you @TPavanBalaji regards.