Apologies if this has already been asked and answered.
First off, my experience with Xamarin Forms has been generally positive on a pure technical level.
But: Right now, I would not recommend it to a colleague as a development platform.
Why: It makes perfect sense that there are a few rough edges around the API and its feature set, and I'm perfectly happy to live with those, so long as there's a central reference point that I can visit to understand:
1. what's currently broken, and when a fix is scheduled for release.
2. what features are going to have design changes in upcoming releases, and how they're going to be changed, and when they're (currently) scheduled for release.
3. how basic, core API features (e.g. LayoutOptions.ExpandAndFill) work.
For example, contrast the official API docs:
FillAndExpand ... describes an element that has no padding around itself and expands http://iosapi.xamarin.com/index.aspx?link=F:Xamarin.Forms.LayoutOptions.FillAndExpand
with what's on the forum from Xamarin staff:
if you use one of the Expand options on a StackLayout and the combined size of its children is less than the height it is allowed and at least one of the children also uses one of the Expand options then those children will get the extra space distributed among them (with StartAndExpand and EndAndExpand controlling where in that additional space the element will appear. http://forums.xamarin.com/discussion/19380/layoutoptions-fill-vs-layoutoptions-fillandexpand
The info (how features work, which features are scheduled to be changed or improved and when, and which features are broken and when they'll be fixed) might all be available, but if so, it seems to be spread across forums and bugzilla, and doesn't seem to make it into the official product documentation.
Where should I be looking?
Am I the only one frustrated by this?