Description

This is a feature request to have the source code updated so that all publicly visible types contain XML code documentation. This serves two purposes

1. Ensures that intellisense is provided for all public types when using MonoGame
2. Ensure that all public types have API Reference documentation generated for the website.

The project to complete this is being tracked at MonoGame Build Warnings Tracker

Based on discussion from #7693, Microsoft has given permission and provided access to the original XNA API reference that can be used to fill in the missing XML code documentation in the source ^[1] as long as the following copyright text is included.

© 2012 Microsoft Corporation. All rights reserved.

Implementation

My suggested implementation of this is to take the XNA API reference documentation provided by Microsoft and use that to complete the missing XML code documentation in the MonoGame source code. However, in doing this, a few questions are posed:

1. Given that Microsoft provided this documentation to the MonoGame foundation, it may not be available to distribute publicly to community members to contribute to this feature. This has been discussed already in the MonoGame discord and I believe the current recommendation is to provide a private repo and have contributing members sign an NDA ^[2]
2. Where should the copyright text be placed? @tomspilman has suggested placing it in the footer of the website along with the MonoGame copyright^[3]. This would satisfy the requirement for the website presence but do we need to also include the copyright information in the source code as well? For instance

/// <summary>
/// Example documentation that might have been provided by microsoft
/// <summary>
/// © 2012 Microsoft Corporation. All rights reserved.

These are the two questions I can think of at the moment, but I'm sure there are more. Regardless, to ensure we remain in legal compliance with the supplied documentation provided by Microsoft, guidelines and a process will need to be established.

Motivation

There are times when the question is asked in the community discord and forums about where to find API reference documentation that is missing ^[4]. Currently we have to point these questions to the MSDN site where the original XNA API reference exists. However, there is no guarantee that Microsoft will keep these pages available.

References:

• Microsoft permission to use XNA documentation ^[1]
• Discord discussion on potential private repo and NDA for access ^[2]
• Tom recommends adding copyright to website footer ^[3]
• Community member asking about SamplerState API reference documentation ^[4]