• Skip to primary navigation
  • Skip to main content
  • Skip to primary sidebar

Yellow Bricks

by Duncan Epping

  • Home
  • ESXTOP
  • Stickers/Shirts
  • Privacy Policy
  • About
  • Show Search
Hide Search

VMware documentation in epub / mobi format?

Duncan Epping · Jun 3, 2011 ·

I just noticed that the Horizon documentation is offered in epub and mobi format. I have been told that this is the first of many more docs to be released in this more universal format. I am happy that VMware decided to adopt this format. It does lead to another question though. I am part of tech marketing and we produce a lot of collateral. Some documents are fairly lengthy and I always have the feeling that many people won’t read docs which are more than 50 pages. Is this any different with epub/mobi? Would you say that these formats enhance readability? If not, what would be a good way of offering documents of between 50 – 150 pages?

Share it:

  • Tweet

Related

Server cloud, documentation, horizon, vSphere

Reader Interactions

Comments

  1. Christopher Wells says

    3 June, 2011 at 08:40

    Duncan,

    Reading technical docs is infinitely easier on a Kindle for example. PDFs are nearly impossible and or poor quality on the Kindle and/or iPad, especially when zooming. The more documentation that can be produced in multiple formats, the better. It’s possible also to convert PDFs into Mobi/ePub as well, although not trivial for pre-existing docs.

    -Chris

  2. Louw Pretorius says

    3 June, 2011 at 08:42

    KB articles should be available in ePub/html

    Technical docs in pdf/ePub/html(for easy referencing in blogs etc)

    Louw

  3. Forbes Guthrie says

    3 June, 2011 at 08:50

    Great news! I suggested this to the doc team over a year ago.
    I’d suggest offering all documents in as many formats as is practical to do. Everyone has different tastes; whether it’s reading onscreen, printing out PDFs, kindles, or using iPads with PDFs or ebooks.
    Personally I’d rather they were ebooks, as reading PDFs on a kindle is painful, and the alternative is printing hard copies.
    HMTL help pages have their place (for reference), but are not so useful if you just want to sit and read. I think all the documentation, whitepapers, technical notes, should be both PDFs and ebook formats. It just a shame that there is not one ebook format suitable for all devices.

  4. Doug Davis says

    3 June, 2011 at 09:12

    Kindle format would be my preference – PDFs end up being downloaded but never fully read.

  5. alexanderjn says

    3 June, 2011 at 09:19

    Disclaimer: I’ve only had ebook experience on an iPad Gen1

    The thing that irks me about technical documentation in ebook format is that text tables and the like rarely appear as they were intended to. With works of fiction this isn’t an issue but manuals commonly have diagrams, screenshots, and tables that get mangled. In PDFs everything is reproduced faithfully.

    That being said I’ll echo Forbes’s opinion that offering both PDF and ebook would be nice and state that I don’t have any qualms about 150+ page documents in either format.

    Lastly, regarding LockLizard PDFs, I’m not a fan. Physical manuals or PDFs but not LockLizard please.

    • Dave Convery says

      3 June, 2011 at 14:00

      I have to echo @Alexanderjn

      I like the idea of e-books for devices like the Kindle and Nook, but newer versions also allow for PDFs anyway.

      I downloaded a sample technical book on my Kindle recently and ended up buying the actual books anyway, but would have preferred a non-locked PDF version because Locklizard is just plain inconvenient.

      There are a few issues with readers: rendering diagrams and tables is sometimes very ugly and there is no ability to easily jump to a page without bookmarks or going back to the TOC. They are a little more difficult to scan (with my eyes and brain!)as well.

  6. Jeroen Bosscher says

    3 June, 2011 at 13:27

    I open PDFs on the Mac and this goes really good, often use the search function when looking up information in these PDFs.

    However, the epub format would be really nice for viewing on the e-reader, especially for people like me who use public transport a lot and can use that time spent for reading documentation. PDFs just don’t open good on the e-reader, especially pictures and diagrams and tables don’t look like they are supposed to do. Epub is really welcome due to this.

    Personally I don’t often read 100+ pages of documentation completely, but I use pieces of this large documentation for getting specific pieces of information.

  7. Scott Lowe says

    3 June, 2011 at 14:37

    I regularly read PDFs on my iPad (Gen 1) and my laptop; I like the idea of being able to read them on either device and not having to worry about the format. I haven’t really seen any issues with readability or quality, either, and there are some very lengthy documents I’ve read (check out some of the EMC TechBooks–talk about lengthy). Personally, I’d prefer to stick with PDF, but I see no harm in VMware distributing other formats as well.

  8. JeffS says

    3 June, 2011 at 14:47

    Hooray for epub. I’m looking forward to see how the formatting turned out. And yes, I frequently read longer documents, though I find that a decent percentage of them usually amounts to fluff.

    I would prefer to see multiple smaller documents. Unfortunately, this generally increases the redundancy.

  9. Andy Hill says

    3 June, 2011 at 16:34

    I would love to see epub and mobi formats. I find it very difficult to read a 50-150 page PDF sitting at a traditional screen, and often have to go to the printer. Reading from printed paper has its disadvantages (no find feature, etc) … bring as much as you can to eReaders!

  10. Manuel Veith says

    3 June, 2011 at 17:42

    Docs I could read on my Kindle would be great.
    I also have your HA and DRS book on my Kindle and I would have never bought it on paper.
    I also don’t like to read long PDF documents.

  11. karlochacon says

    3 June, 2011 at 17:44

    I prefer PDF….lately I’ve been converting some epub files to PDF…it’s maybe I don’t have ipad on the other hand same thin I prefer PDF over Kindle

  12. Dan Hayward says

    3 June, 2011 at 17:46

    I’d say that anything eBook compatible would be a good move… at least you’d have the choice to read it on the move more easily…

  13. Rick Boyett says

    3 June, 2011 at 18:19

    ROCK the MOBI (^_^)

    I have all my VMware PDF docs on my Kindle but they don’t read well unless in landscape mode or unless you zoom in. These are acceptable work arounds but the Mobi format would be easier to deal with for me.

    But I’m planning to get a tablet that supports PDF and Kindle so I guess it won’t be as important..

  14. Carter Shanklin says

    3 June, 2011 at 19:10

    We need to stop producing PDF altogether and offer HTML and MOBI formats for everything. Amazingly some VMW docs are *only* in PDF.

  15. Jim Bodkin says

    3 June, 2011 at 19:36

    My vote is for epub and PDF. I rarely read longer documents in their entirety but rather search them for specific items. Epub documents are great, except for occasional diagram/picture problems, when I am traveling and want a lot of documentation with me.

  16. Christopher Di Biase says

    5 June, 2011 at 14:53

    Personally I have a hard time with long form reading on any type of backlit LCD panel. I bought a Kindle after playing with one in the store and have found it is MUCH easier to read long form on that device.

    To that end I’ve been eagerly waiting for either VMware (and others) to put out documentation in a .mobi so I can read it, or for Amazon to figure out how to reflow PDF files so they are readable on the 6″ screen of the kindle. (that or I may just break down and get the 10″ version at some point heh).

  17. Ben says

    6 June, 2011 at 14:07

    Fantastic! I’d love it if all docs on VMware’s site were available in kindle & nook format in addition to PDF. While studying for the VCP, I would have preferred to read them off the Nook I had at the time instead of printing them out on paper(nook wouldn’t display PDF’s properly).

  18. Sven says

    13 June, 2011 at 21:29

    Highly appreciated! After getting my first Kindle some weeks ago I started to put all my documentation on this beloved device – not the best results by converting PDF, but much better to read than on a laptop or killing trees for printed versions.

  19. Ed Wilts says

    17 June, 2011 at 22:43

    Kindle all the way. I already bought the HA/DRS book and the ExamCram in Kindle format. If I had the full doc set available in Kindle format, I’d be tempted to buy another Kindle and haul it back and forth to work. I hate PDFs for documentation.

  20. Chris says

    30 June, 2011 at 11:17

    Any ETA on when the VMware documentation will be released for the kindle?

  21. Foster says

    20 September, 2011 at 13:12

    I was visiting the VSphere 5.0 documentation website and downloaded some epubs. They were in zip format. When I opened them there was no epub file. Is there something I am supposed to do with this zip file in order to view it on my reader?
    Here is the site:
    http://pubs.vmware.com/vsphere-50/index.jsp?topic=/com.vmware.vsphere.install.doc_50/GUID-7C9A1E23-7FCD-4295-9CB1-C932F2423C63.html

    • Foster says

      20 September, 2011 at 20:48

      Go to the bottom of the left pane and select ‘PDF and e-book Product Documentation’. Try downloading the epub and let me know what you can get out of it.

      • Foster says

        22 September, 2011 at 14:39

        I did some Google searhing and found out you need to change the file extension from .zip to .epub after creating the epub. It then opens and works fine. You would think VMWare would let you know that on their documentation page. Either that or change the extension before putting up the file on their site.

Primary Sidebar

About the author

Duncan Epping is a Chief Technologist in the Office of CTO of the Cloud Platform BU at VMware. He is a VCDX (# 007) and the author of the "vSAN Deep Dive" and the “vSphere Clustering Technical Deep Dive” series.

Upcoming Events

04-Mar-21 | Polish VMUG – Roadshow
09-Mar-21 | Austria VMUG – Roadshow
16-Mar-21 | VMUG Turkey – Roadshow
18-Mar-21 | St Louis Usercon Keynote
26-Mar-21 | Hungary VMUG – Roadshow
08-Apr-21 | VMUG France – Roadshow

Recommended reads

Sponsors

Want to support us? Buy an advert!

Advertisements

Copyright Yellow-Bricks.com © 2021 · Log in