• View Communities
    • Citrix Developer Network
      The place for unfiltered straight talk on Citrix products. Blogs, code downloads, best practices, APIs, and more can all be found here.
    • Citrix Ready Community Verified
      Does it work with Citrix? Application compatibility questions are a thing of the past with the new Citrix Community Verified site.
    • Blogs
      Learn the latest from the Citrix employees who are building application delivery infrastructure technologies.
    • Blogosphere
      The Citrix Blogosphere is a window into the thousands of conversations taking place about Citrix and Application Delivery.
  •  Sign In
The Citrix Blog
Personal Blog
Andy McAleer
Related Tags
posted by Andy McAleer

The Citrix Technical Publications team is considering a change to the way we publish readmes, and I like to get your input on this subject.

Readmes are HTML documents that ship on product CDs/DVDs. We also published updated readmes on the web. These documents inform you of late-breaking information, critical pre-installation advice, and other started information that, generally speaking, you need at only one time before you install the product. At least, that how Citrix view the purpose of our readmes. Is that how you use them?

The change we considering is to dispense with the readmes on the product media (CD or DVD), and instead publish them only on our website. The benefits are that you only ever see one readme (the up-to-date document on the web) not two (the web-based one *and* the out-of-date document on the media, which you or your team still might feel the need to open, check, process, etc. which could be a time-consuming). />

So how do you feel about the possibility that we drop readmes from the CD/DVD? Below are a few other more detailed questions that you might also want to consider.

location

  • In your Citrix deployment lifecycle, at what stage do you refer to a product readme? Before installation, during installation and configuration, during troubleshooting, never? Do you consult the readme at more than one of these stages? Perhaps you refer back to this document before installation and then again while troubleshooting.
  • Would you refer to a readme if it were on the Citrix website?
  • Furthermore, would you be happy if a readme were located only on our website (for example, where the product installer provided a link to the readme on the web)? Or would that present any problems to your organization or workflow?

Readme content

  • What information are you expecting to see in our readmes? Essential late-breaking info, bugs, installation instructions, configuration instructions? Anything else?
  • Do you find the answers you need in our readmes?
  • Do you find readmes easy to read and navigate through?

Post a reply with your thoughts, and have your say.

Thanks! McAleer
Senior Technical Writer
Technical Publications team

Labels

lang-eng lang-eng Delete
nonspecific nonspecific Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.
  1. May 02, 2007

    Anonymous says:

    So how do you feel about the possibility that we drop readmes from the CD/DVD? ...

    So how do you feel about the possibility that we drop readmes from the CD/DVD?

    I never used them (I check online version at support.citrix.com)

    In your Citrix deployment lifecycle, at what stage do you refer to a product readme?

    Before installation and eventually during troubleshooting

    Do you consult the readme at more than one of these stages?

    No

    Would you refer to a readme if it were on the Citrix website?

    Yes

    Furthermore, would you be happy if a readme were located only on our website ?

    Yes

    Would that present any problems to your organization or workflow?

    No

    What information are you expecting to see in our readmes? Essential late-breaking info, bugs, installation instructions, configuration instructions? Anything else?

    All of them and may be Best practice, deployment case studies...

    Do you find the answers you need in our readmes?

    Concerning installation issue, usually, yes

    Do you find readmes easy to read and navigate through?

    Yes

Add Comment