Bug 52512 - Incorrect documentation of Xamarin.Forms.Color
Summary: Incorrect documentation of Xamarin.Forms.Color
Status: RESOLVED FIXED
Alias: None
Product: Forms
Classification: Xamarin
Component: Forms ()
Version: 2.3.3
Hardware: PC Windows
: --- normal
Target Milestone: ---
Assignee: Chris King
URL:
Depends on:
Blocks:
 
Reported: 2017-02-14 22:31 UTC by John Hardman
Modified: 2017-03-22 20:53 UTC (History)
5 users (show)

Tags: Xamarin.Forms Color documentation ac
Is this bug a regression?: ---
Last known good build:

Notice (2018-05-24): bugzilla.xamarin.com is now in read-only mode.

Please join us on Visual Studio Developer Community and in the Xamarin and Mono organizations on GitHub to continue tracking issues. Bugzilla will remain available for reference in read-only mode. We will continue to work on open Bugzilla bugs, copy them to the new locations as needed for follow-up, and add the new items under Related Links.

Our sincere thanks to everyone who has contributed on this bug tracker over the years. Thanks also for your understanding as we make these adjustments and improvements for the future.


Please create a new report on Developer Community or GitHub with your current version information, steps to reproduce, and relevant error messages or log files if you are hitting an issue that looks similar to this resolved bug and you do not yet see a matching new report.

Related Links:
Status:
RESOLVED FIXED

Description John Hardman 2017-02-14 22:31:16 UTC
The documentation at the following url is supposed to be about Xamarin.Forms.Color, but lists a whole load of stuff that is not Xamarin.Forms.Color-related (Windows 10 possibly?)

https://developer.xamarin.com/api/type/Xamarin.Forms.Color/
Comment 1 adrianknight89 2017-02-17 23:42:53 UTC
You mean the new colors shouldn't be there? 

See https://github.com/xamarin/Xamarin.Forms/pull/393
Comment 2 John Hardman 2017-02-20 09:47:25 UTC
@adrianknight89@outlook.com - Ah, didn't know that was happening. Unusual that the documentation is ahead of the latest stable release (I am using 2.3.3.180 and the additional named colors are not available in that). Not sure that should be happening, unless clearly indicated in the documentation. Think that's another item to go on the Release Management checklist.

The section in the documentation that shows the following, needs updating/clarification to avoid confusion:

"Namespace: Xamarin.Forms
Assembly: Xamarin.Forms.Core (in Xamarin.Forms.Core.dll)
Assembly Versions: 1.0.0.0, 1.1.0.0, 1.2.0.0, 1.3.0.0, 1.4.0.0, 1.5.0.0, 2.0.0.0
The members of Xamarin.Forms.Color are listed below."
Comment 3 Paul DiPietro [MSFT] 2017-02-22 15:09:40 UTC
I'll see what the documentation team wants to do about this as it probably just needs to be updated.
Comment 4 Chris King 2017-03-22 19:30:23 UTC
Will forward to Mr. Norman.
Comment 5 Chris King 2017-03-22 20:53:34 UTC
Going forward, docs will match the latest non-pre-release on nuget.org.