← Back to branch summary

~ubuntu-branches/ubuntu/trusty/monodevelop/trusty-proposed

« back to all changes in this revision

Viewing changes to external/Newtonsoft.Json/Doc/Introduction.aml

  • Committer: Package Import Robot
  • Author(s): Jo Shields
  • Date: 2013-05-12 09:46:03 UTC
  • mto: This revision was merged to the branch mainline in revision 29.
  • Revision ID: package-import@ubuntu.com-20130512094603-mad323bzcxvmcam0
Tags: upstream-4.0.5+dfsg
Import upstream version 4.0.5+dfsg

Show diffs side-by-side

added added

removed removed

Lines of Context:
external/Newtonsoft.Json/Doc/Introduction.aml
 
1
<?xml version="1.0" encoding="utf-8"?>
 
2
<topic id="Introduction" revisionNumber="1">
 
3
  <developerConceptualDocument xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5" xmlns:xlink="http://www.w3.org/1999/xlink">
 
4
    <!--
 
5
    <summary>
 
6
      <para>Optional summary abstract</para>
 
7
    </summary>
 
8
    -->
 
9
    <introduction>
 
10
      <para>Json.NET is a popular high-performance JSON framework for .NET</para>
 
11
    </introduction>
 
12
    <!-- Optional procedures followed by optional code example but must have
 
13
         at least one procedure or code example -->
 
14
<section>
 
15
 <title>Benefits and Features</title>
 
16
<content>
 
17
<list class="bullet">
 
18
   <listItem>
 
19
        <para>Flexible JSON serializer for converting between .NET objects and JSON</para>
 
20
    </listItem>
 
21
   <listItem>
 
22
        <para>LINQ to JSON for manually reading and writing JSON </para>
 
23
    </listItem>
 
24
   <listItem>
 
25
        <para>High performance, faster than .NET's built-in JSON serializers</para>
 
26
    </listItem>
 
27
   <listItem>
 
28
        <para>Write indented, easy to read JSON</para>
 
29
    </listItem>
 
30
   <listItem>
 
31
        <para>Convert JSON to and from XML</para>
 
32
    </listItem>
 
33
   <listItem>
 
34
        <para>Supports .NET 2, .NET 3.5, .NET 4, .NET 4.5, Silverlight, Windows Phone and Windows 8 RT</para>
 
35
    </listItem>
 
36
 
 
37
</list>
 
38
<para>The JSON serializer in Json.NET is a good choice when the JSON you are reading or writing maps closely to a .NET class.</para>
 
39
<para>LINQ to JSON is good for situations where you are only interested in
 
40
getting values from JSON, you don't have a class to serialize or deserialize to, 
 
41
or the JSON is radically different from your class and you need to manually read 
 
42
and write from your objects.</para>
 
43
</content>
 
44
</section>
 
45
 
 
46
<section>
 
47
 <title>Getting Started</title>
 
48
 <content>
 
49
 
 
50
<list class="bullet">
 
51
  <listItem><para><externalLink>
 
52
<linkText>Serializing and Deserializing JSON</linkText>
 
53
<linkUri>SerializingJSON.htm</linkUri>
 
54
<linkTarget>_self</linkTarget>
 
55
</externalLink></para></listItem>
 
56
  <listItem><para><externalLink>
 
57
<linkText>LINQ to JSON</linkText>
 
58
<linkUri>LINQtoJSON.htm</linkUri>
 
59
<linkTarget>_self</linkTarget>
 
60
</externalLink></para></listItem>
 
61
</list>
 
62
 
 
63
 </content>
 
64
</section>
 
65
<section>
 
66
 <title>History</title>
 
67
 <content><para>Json.NET grew out of projects I was working on in late 2005 involving JavaScript,
 
68
            AJAX and .NET. At the time there were no libraries for working with JavaScript in
 
69
            .NET so I made my own.</para>
 
70
 <para>Starting out as a couple of static methods for escaping JavaScript strings, Json.NET
 
71
            evolved as features were added. To add support for reading JSON a major refactor
 
72
            was required and Json.NET will split into the three major classes it still uses
 
73
            today, JsonReader, JsonWriter and JsonSerializer.</para>
 
74
 <para>Json.NET was first released in June 2006. Since then Json.NET has been downloaded
 
75
            hundreds of thousands of times by developers around the world. It is used in many major open
 
76
            source projects including <externalLink>
 
77
                <linkText>Mono</linkText>
 
78
                <linkUri>http://www.mono-project.com/</linkUri>
 
79
                <linkTarget>_blank</linkTarget>
 
80
            </externalLink>,
 
81
            an open source implementation
 
82
            of the .NET framework; <externalLink>
 
83
                <linkText>RavenDB</linkText>
 
84
                <linkUri>http://ravendb.net/</linkUri>
 
85
                <linkTarget>_blank</linkTarget>
 
86
            </externalLink>,
 
87
            a JSON based documentat database; <externalLink>
 
88
                <linkText>SignalR</linkText>
 
89
                <linkUri>http://signalr.net/</linkUri>
 
90
                <linkTarget>_blank</linkTarget>
 
91
            </externalLink>,
 
92
            an async library for building real-time, multi-user interactive web applications; and <externalLink>
 
93
                <linkText>ASP.NET Web API</linkText>
 
94
                <linkUri>http://www.asp.net/web-api</linkUri>
 
95
                <linkTarget>_blank</linkTarget>
 
96
            </externalLink>,
 
97
            Microsoft's HTTP service framework.</para>
 
98
  <para><externalLink>
 
99
                <linkText>James Newton-King</linkText>
 
100
                <linkUri>http://twitter.com/jamesnk</linkUri>
 
101
                <linkTarget>_blank</linkTarget>
 
102
            </externalLink></para>
 
103
</content>
 
104
</section>
 
105
 
 
106
<section>
 
107
 <title>Donate</title>
 
108
 <content><para>Json.NET is a free open source project developed in my own time.</para>
 
109
 <para>I really appreciate your feedback and donations help support Json.NET and its future development.</para></content>
 
110
</section>
 
111
 
 
112
 <markup>
 
113
 <p>
 
114
 <a target="_blank" href="https://www.paypal.com/cgi-bin/webscr?cmd=_donations&amp;business=james%40newtonking%2ecom&amp;item_name=Supporting%20Json%2eNET&amp;no_shipping=0&amp;no_note=1&amp;tax=0&amp;currency_code=USD&amp;lc=US&amp;bn=PP%2dDonationsBF&amp;charset=UTF%2d8">
 
115
            <img style="border-width:0;" alt="Donate" src="../donate.gif" />
 
116
            </a>
 
117
 </p>
 
118
 </markup>
 
119
    <relatedTopics>
 
120
      <externalLink>
 
121
        <linkText>Serializing and Deserializing JSON</linkText>
 
122
        <linkUri>SerializingJSON.htm</linkUri>
 
123
        <linkTarget>_self</linkTarget>
 
124
      </externalLink>
 
125
      <externalLink>
 
126
        <linkText>LINQ to JSON</linkText>
 
127
        <linkUri>LINQtoJSON.htm</linkUri>
 
128
        <linkTarget>_self</linkTarget>
 
129
      </externalLink>
 
130
    </relatedTopics>
 
131
 
 
132
  </developerConceptualDocument>
 
133
</topic>
 
 
b'\\ No newline at end of file'