Better organized links section in the readme and doc intro page

Removed the "work in progress" verbiage, which no longer applies now we're
stabilizing for Build.

Organized what was becoming a wall of too many links into sections "Where to
get it", "How to use it", and "More info".

Added a source code link to README.md, so people with clones of the source can
always find their way back to its origin.

Made the links to Example Gallery more visible.

Added an explicit "Report a bug or ask a question" link, as several customers
recently were unsure where to do that.
This commit is contained in:
Shawn Hargreaves 2015-04-16 19:49:29 -07:00
Родитель 8a726de361
Коммит 5a56c8f8ed
2 изменённых файлов: 47 добавлений и 32 удалений

Просмотреть файл

@ -6,17 +6,24 @@ writing Windows apps for Windows 8.1, Windows Phone 8.1 and Windows 10. It
utilizes the power of Direct2D, and integrates seamlessly with XAML and
CoreWindow.
Win2D is work in progress and evolving rapidly. The goal of releasing this code
in an early, incomplete state is to solicit early developer feedback.
##### Where to get it
- [NuGet packages](http://www.nuget.org/packages/Win2D)
- [Source code](http://github.com/Microsoft/Win2D)
##### How to use it
- [Documentation](http://microsoft.github.io/Win2D)
- Example Gallery
[source code](https://github.com/Microsoft/Win2D/tree/master/tests/ExampleGallery/Shared),
[Windows](http://apps.microsoft.com/windows/en-us/app/win2d-example-gallery/b668cfe1-e280-4c1e-adc1-09b7981ab084) and
[Phone](http://www.windowsphone.com/en-us/store/app/win2d-example-gallery/8797b9cb-1443-475f-9a43-dd959de6fcc1) apps
##### More info
- [Features](http://github.com/Microsoft/Win2D/wiki/Features) - *what's implemented so far*
- [Backlog](http://github.com/Microsoft/Win2D/wiki/Backlog) - *what we plan to add next*
- [Team blog](http://blogs.msdn.com/b/win2d)
- [Report a bug or ask a question](http://github.com/Microsoft/Win2D/issues)
- [License](http://www.apache.org/licenses/LICENSE-2.0.html)
- [Contributing](http://github.com/Microsoft/Win2D/blob/master/CONTRIBUTING.md)
- Example Gallery for [Windows](http://apps.microsoft.com/windows/en-us/app/win2d-example-gallery/b668cfe1-e280-4c1e-adc1-09b7981ab084) and [Phone](http://www.windowsphone.com/en-us/store/app/win2d-example-gallery/8797b9cb-1443-475f-9a43-dd959de6fcc1) - *source code [here](https://github.com/Microsoft/Win2D/tree/master/tests/ExampleGallery/Shared)*
## Code Example
To give you a flavor of what the code looks like, here is a snippet of XAML:

Просмотреть файл

@ -25,24 +25,46 @@ under the License.
CoreWindow.
</para>
<para>
Win2D is work in progress and evolving rapidly. The goal of releasing this
code in an early, incomplete state is to solicit early developer feedback.
</para>
<para>Where to get it:</para>
<list class="bullet">
<listItem>
<externalLink>
<linkText>Source code and issue tracking</linkText>
<linkUri>http://github.com/Microsoft/Win2D</linkUri>
</externalLink>
</listItem>
<listItem>
<externalLink>
<linkText>NuGet packages</linkText>
<linkUri>http://www.nuget.org/packages/Win2D</linkUri>
</externalLink>
</listItem>
<listItem>
<externalLink>
<linkText>Source code</linkText>
<linkUri>http://github.com/Microsoft/Win2D</linkUri>
</externalLink>
</listItem>
</list>
<para>Example Gallery:</para>
<list class="bullet">
<listItem>
<externalLink>
<linkText>Source code</linkText>
<linkUri>https://github.com/Microsoft/Win2D/tree/master/tests/ExampleGallery/Shared</linkUri>
</externalLink>
</listItem>
<listItem>
<externalLink>
<linkText>Windows</linkText>
<linkUri>http://apps.microsoft.com/windows/en-us/app/win2d-example-gallery/b668cfe1-e280-4c1e-adc1-09b7981ab084</linkUri>
</externalLink>
and
<externalLink>
<linkText>Phone</linkText>
<linkUri>http://www.windowsphone.com/en-us/store/app/win2d-example-gallery/8797b9cb-1443-475f-9a43-dd959de6fcc1</linkUri>
</externalLink>
apps
</listItem>
</list>
<para>More info:</para>
<list class="bullet">
<listItem>
<externalLink>
<linkText>Features</linkText>
@ -64,24 +86,10 @@ under the License.
</externalLink>
</listItem>
<listItem>
Example Gallery for
<externalLink>
<linkText>Windows</linkText>
<linkUri>http://apps.microsoft.com/windows/en-us/app/win2d-example-gallery/b668cfe1-e280-4c1e-adc1-09b7981ab084</linkUri>
<linkText>Report a bug or ask a question</linkText>
<linkUri>http://github.com/Microsoft/Win2D/issues</linkUri>
</externalLink>
and
<externalLink>
<linkText>Phone</linkText>
<linkUri>http://www.windowsphone.com/en-us/store/app/win2d-example-gallery/8797b9cb-1443-475f-9a43-dd959de6fcc1</linkUri>
</externalLink>
-
<legacyItalic>
source code
<externalLink>
<linkText>here</linkText>
<linkUri>https://github.com/Microsoft/Win2D/tree/master/tests/ExampleGallery/Shared</linkUri>
</externalLink>
</legacyItalic>
</listItem>
</list>
</introduction>
@ -141,7 +149,7 @@ under the License.
<listItem>
Add a CanvasControl inside the existing Grid control:
<code>
&lt;Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}"&gt;
&lt;Grid&gt;
&lt;canvas:CanvasControl Draw="CanvasControl_Draw" ClearColor="CornflowerBlue"/&gt;
&lt;/Grid&gt;
</code>