Code review comment for lp:~clissold345/ubuntu-docs/fix-for-1569532

Revision history for this message
Gunnar Hjalmarsson (gunnarhj) wrote :

Besides Doug's comment, which I agree on, I don't think that this page fits well in the "Install & remove software" section. I would suggest that it's renamed and placed in the "Disks & storage" section instead, which deals with things affecting whole partitions.

As regards the contents, the term "CD image" sounds a bit dated considering that most images don't fit on a CD nowadays. I suggest "DVD image" or just "image". Also, I think that the term "ISO file" should be mentioned at least once.

These are the changes I propose:

gunnar@gunnar-ubuntu-current:/media/gunnar/ubuntu-dev/home/gunnar/UbuntuDev/bzr/ubuntu-docs/trunk/ubuntu-help/C$ diff -u addremove-creator.page disk-creator.page
--- addremove-creator.page 2017-01-02 20:41:02.965027000 +0100
+++ disk-creator.page 2017-01-02 21:54:22.961657670 +0100
@@ -1,6 +1,6 @@
 <page xmlns="http://projectmallard.org/1.0/"
       type="topic" style="task"
- id="addremove-create">
+ id="disk-creator">

   <info>
     <credit type="author">
@@ -12,8 +12,7 @@
     </desc>

     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
- <link type="guide" xref="addremove" group="#first"/>
- <link type="seealso" xref="addremove-install-synaptic"/>
+ <link type="guide" xref="disk"/>
     <revision version="16.04" date="2016-03-13" status="review"/>
   </info>

@@ -25,9 +24,9 @@
   The capacity of the USB flash drive must be at least 2 GB.
   Any data on the USB flash drive will be lost when you create the startup disk.</p>

- <p>It's assumed that you have downloaded an Ubuntu CD image.</p>
+ <p>It's assumed that you have downloaded an Ubuntu image (ISO file).</p>

- <p>To create a startup disk from an Ubuntu CD image:</p>
+ <p>To create a startup disk from an Ubuntu image:</p>

   <steps>
     <item>
@@ -37,8 +36,8 @@
     </item>
     <item>
       <p>
- If the CD image is in your <gui>Download</gui> folder and there is just one CD image, <app>Startup Disk Creator</app> will have selected it,
- otherwise select the correct CD image.
+ If the image is in your <gui>Download</gui> folder and there is just one image, <app>Startup Disk Creator</app> will have selected it,
+ otherwise select the correct image.
       </p>
     </item>
     <item>

review: Needs Fixing

« Back to merge proposal