Request for review for .img file writing instructions

Emmet Hikory persia at ubuntu.com
Tue Apr 21 02:17:53 UTC 2009


Matthew East wrote:
> On Mon, Apr 20, 2009 at 10:46 AM, Emmet Hikory <persia at ubuntu.com> wrote:
>> Documentation Team,
>>    I've put together a short outline for how to write .img files to USB
>> sticks or flash cards (1).  I'd like to request that someone review this
>> document, and let me know what else is needed to make it suitable to be
>> included with the regular Ubuntu documentation.
>>
>>    Ideally, I'd like to place it somewhere in parallel to the
>> instructions to turn a .iso file into useful media (2).  Suggestions on
>> an appropriate URL would be welcome.
>>
>> 1: https://wiki.ubuntu.com/Installation/FromIMGFiles
>> 2: https://help.ubuntu.com/community/BurningIsoHowto
> 
> I think to be consistent and most effective, this should be integrated
> into this document:
> 
> https://help.ubuntu.com/community/Installation/FromUSBStick
> 
> That page currently deals with how to install an .iso file from a USB
> stick, and ideally I think it should be split into two sections (or
> maybe even subpages), the first dealing with .iso files, and the
> second dealing with .img files.
> 
> Does that make sense?

    It does make some sense.  I've interleaved the approaches for .iso
files and .img files between the Automatic and Manual sections, and
included a note about checking the MD5SUMS (borrowed from
BurningIsoHowto).  On the other hand, I'm unsure that such a general
page is suitable as a landing page for users that are downloading a .img
file, and just want a quick path to install: the instructions for
converting a .iso file may be confusing.

    I was initially thinking of something more along the lines of
community/WritingImgHowto to parallel BurningIsoHowto.  Would this make
sense?  I could perhaps use inclusion for common portions of these pages
to reduce maintenance overhead.

-- 
Emmet HIKORY





More information about the ubuntu-doc mailing list