Why aren’t installation issues in the installation guide?

Why aren’t installation issues in the installation guide?

  • Comments 5

One of the Team Foundation managers recently asked me why we have a separate Readme document. The Readme, by definition, is for setup related issues, while the Known Issues document is for operational, non-setup issues. (You can view the Readme and Known Issue documents here: http://msdn2.microsoft.com/en-us/teamsystem/aa902633.aspx)


We already publish the Installation Guide separately from the rest of the documentation on MSDN. This gives us the flexibility to update the Installation Guide as often as needed. (You can download the Installation Guide from here: http://www.microsoft.com/downloads/details.aspx?familyid=E54BF6FF-026B-43A4-ADE4-A690388F310E&displaylang=en)


Some setup issues are published in both the Readme and in the Installation Guide. This duplication makes updating the documents more difficult and information in one document does not always make it into the other. It would make sense to combine the Readme with the Installation Guide – putting the setup related issues in a Readme section within the Installation Guide. Users would be able to see all of the setup documentation in one place, and updates to the Readme items could still be published as needed.


I would like your feedback. Do you like having a separate Readme document published under MSDN Support, or would you prefer to have setup related issues included only in the Installation Guide?


Let me know by sending us e-mail at vstsuetb@microsoft.com. I’ll collect the feedback and follow up with a post early next month on the results. This is your opportunity to contribute to a change in the look of the content.



Allison Bokone

Leave a Comment
  • Please add 6 and 1 and type the answer here:
  • Post
  • My previous team, Team System User Education , wants your feedback on publishing a consolidated set of

  • Noah Coad on Real TFS Command Line Help. The Visual Studio Team System User Education blog on Why...

  • Los que ya habéis instalado Team Foundation Server, sabéis que, a pesar de ser tan "sencillo" como seguir

  • Having more than one document is a nightmare. With so many versions it's near impossible to ensure you've printed the versions that match.  If you have mismatched documents you run the risk of invalidating the installation.

    One document would be fabulous.

  • Last month I created a blog entry and asked for feedback about combining the Team Foundation Readme and

Page 1 of 1 (5 items)