Bug 39242 - Website information out of date
Summary: Website information out of date
Status: RESOLVED FIXED
Alias: None
Product: Documentation
Classification: Xamarin
Component: Multi-Platform ()
Version: unspecified
Hardware: PC Mac OS
: --- normal
Target Milestone: ---
Assignee: CraigD
URL:
Depends on:
Blocks:
 
Reported: 2016-03-01 11:20 UTC by Paul Johnson
Modified: 2016-03-02 08:44 UTC (History)
1 user (show)

Tags:
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 Paul Johnson 2016-03-01 11:20:34 UTC
https://developer.xamarin.com/guides/xamarin-forms/getting-started/introduction-to-xamarin-forms/

The instructions for WinPhone is out of date. The inherited FormsApplicationPage doesn't exist, instead, it should just be the default of public sealed partial class MainPage.

The XAML has also changed (not sure if that is on the website or not) to be

<forms:WindowsPhonePage
    x:Class="NAMESPACE.WinPhone.MainPage"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
    xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
    xmlns:forms="using:Xamarin.Forms.Platform.WinRT"
    mc:Ignorable="d"
    Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
</forms:WindowsPhonePage>
Comment 1 CraigD 2016-03-02 04:37:16 UTC
The linked documented is out-of-date - however it's not so much "wrong" as still referring to the Windows Phone 8 (Silverlight) platform support, rather than the newer WinRT support that is only now becoming the default in our project templates.

The details & instructions for the WinRT and UWP platforms are available here:
https://developer.xamarin.com/guides/xamarin-forms/platform-features/windows/installation/

Minor updates have been made to the page to help prevent confusion -- thanks for bringing this to our attention. We'll make further updates when the new templates are fully rolled out.
Comment 2 Paul Johnson 2016-03-02 07:43:47 UTC
Thanks - will these changes also be reflected in the github code? I found it confusing that there are two repos for forms, one using the "old" (Silverlight) and one using the "new" (WinRT)
Comment 3 CraigD 2016-03-02 08:08:54 UTC
Which repos are you referring to?

The main Xamarin.Forms repo is located at
https://github.com/xamarin/xamarin-forms-samples
and is gradually being updated so that all samples have all four Windows project types (Phone8SL, Phone8RT, Windows8RT, Windows10UWP). You'll find some samples in there currently have all four, but as Phone8SL was the "original" supported platform, it is the one that current exists in all samples. 

This is also the repo that backs all the documentation and samples on https://developer.xamarin.com/samples/xamarin-forms/all/

The other repos we have with Xamarin.Forms samples are the book repos:
https://github.com/xamarin/xamarin-forms-book-preview
https://github.com/xamarin/xamarin-forms-book-preview-2
The first is rather out-of-date however Charles has made a big effort to ensure the second-preview samples are all updated to Xamarin.Forms 2.0 and include all fours Windows platforms (both the original Phone8SL _and_ the three newer ones).
Comment 4 Paul Johnson 2016-03-02 08:39:06 UTC
From memory, aren't there some in the mobile-samples repo as well?
Comment 5 CraigD 2016-03-02 08:44:40 UTC
Generally there should not be - that repo is intended to highlight how Xamarin helps to leverage code sharing and native user-interfaces _without_ using Xamarin.Forms.