The documentation needs seperation between PC and XBox 360

redshock


I'm trying really hard to enjoy XNA. It seems like a clean break from native programming. I enjoy the innovation that MS gave, but maybe its just their docs that are just annoying right now. I read the docs and when I try to follow something on the Windows development side, it goes right into the XBox code and doesn't give me the source code I need for Windows. I thought I was reading a Windows section too, or sometimes hoping that I am. I wish Microsoft could seperate the differences because right now its just "oh and while you're doing reading about what relates to Windows development here, take a look at the XBox code below." All I can say right now is the documentation needs some seperating. I'm do PC development and I have no care how machine #2 differs, especially when it only gives me machine #2's source code. Sure, its somewhat of a rant, but MS is on the right track, had deadlines and all which is reasonable, etc., but the documentation definitely needs some rearranging. It's like VB.NET and C# programming. They both do basically the same calls, but the details differ. The Visual Studio team recognized that and made a seperation between how VB.NET and C# did a task. I would suggest doing the same between the PC and XBox 360. I'm just not finding what I am looking for although it gives me the code for machine #2, but it doesn't even explain the difference for machine #1 almost half the time I look up something.  

Shawn Hargreaves - MSFT


What areas of the documentation are you looking at where things are different

As far as I'm aware, the vast majority of our documentation applies equally to both platforms, because the API is the same on both.

Michael Klucher - MSFT

Shawn is correct most of the documentation should work on PC just like it would on your Xbox 360 Console, if you are running into specific areas that are problems please file a bug on Microsoft Connect https://connect.microsoft.com/site/sitehome.aspx SiteID=226

Bonnie Lehenbauer

I have noticed that there is not a good way to filter out the DirectX documentation from the XNA documentation when using the search tool in document explorer or on MSDN. If you search for a computer graphics concept it is often difficult to differentiate between DirectX documents and XNA documents in the results.

Is this what you mean We are currently looking into ways to improve the documentation search so you can look just for XNA documents.