You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/content/index.md
+57-32Lines changed: 57 additions & 32 deletions
Original file line number
Diff line number
Diff line change
@@ -1,53 +1,70 @@
1
1
F# Data: Library for Data Access
2
2
================================
3
3
4
-
The F# Data library (`FSharp.Data.dll`) implements everything you need to
5
-
access data in your F# applications and scripts. It implements F# type
4
+
The F# Data library implements everything you need to
5
+
access data in your F# applications and scripts. It contains F# type
6
6
providers for working with structured file formats (CSV, JSON and XML)
7
-
and for accessing the WorldBank and Freebase data. It also includes helpers for parsing
7
+
and for accessing the WorldBank and Freebase services. It also includes helpers for parsing
8
8
JSON and CSV files and for sending HTTP requests.
9
9
10
-
### Library philosophy
11
-
12
-
This library focuses on providing a simple read-only access to the structured documents
10
+
This library focuses on providing a simple, mostly read-only, access to the structured documents
13
11
and other data sources. It does not aim to be a comprehensive collection of F# type providers
14
12
(which can be used for numerous other purposes). It's also designed to play well with other libraries
15
-
like [Deedle](http://bluemountaincapital.github.io/Deedle), [F# R Type Provider](http://bluemountaincapital.github.io/FSharpRProvider), [F# Charting](http://fsharp.github.io/FSharp.Charting) and [FunScript](http://funscript.info).
16
-
17
-
### Library license
18
-
19
-
The library is available under Apache 2.0. For more information see the
20
-
[License file][license] in the GitHub repository. In summary, this means that you can
21
-
use the library for commercial purposes, fork it, and modify it as you wish.
22
-
23
-
<br/><hr/>
24
-
25
-
# How to get FSharp.Data
13
+
like [Deedle](http://bluemountaincapital.github.io/Deedle), [R Type Provider](http://bluemountaincapital.github.io/FSharpRProvider),
14
+
[F# Charting](http://fsharp.github.io/FSharp.Charting) and [FunScript](http://funscript.info).
* The F# Data Library is available as <ahref="https://nuget.org/packages/FSharp.Data">FSharp.Data on NuGet</a>.
28
-
29
-
* In addition to the official releases, you can also get NuGet packages from the [Continuous Integration package source](https://ci.appveyor.com/nuget/fsharp-data-q9vtdm6ej782).
47
+
In addition to the official releases, you can also get NuGet packages from the [Continuous Integration
* Alternatively, you can download the [source as a ZIP file][source] or download the [compiled binaries][compiled] as a ZIP. <br /> Please note that on windows when downloading a zip file with `dll` files the files will be blocked, and you have to manually unblock them in the file properties.
32
51
33
-
<br/><hr/>
34
52
35
-
# Using F# Data
53
+
F# Data documentation and tutorials
54
+
-----------------------------------
36
55
37
56
### F# type providers
38
57
39
58
The type providers for structured file formats infer the structure of a sample
40
59
document (or a document containing multiple samples). The structure is then used
41
60
to provide easy to use type-safe access to documents that follow the same structure.
42
-
For more information see:
61
+
The library also implements a type provider for accessing data from
62
+
[the WorldBank](http://data.worldbank.org/) and [Freebase graph database](http://www.freebase.com/).
63
+
43
64
44
65
*[XML Type Provider](library/XmlProvider.html) - discusses the `XmlProvider<..>` type
45
66
*[JSON Type Provider](library/JsonProvider.html) - discusses the `JsonProvider<..>` type
46
67
*[CSV Type Provider](library/CsvProvider.html) - discusses the `CsvProvider<..>` type
47
-
48
-
The library also implements a type provider for accessing data from
49
-
[the WorldBank](http://data.worldbank.org/) and [Freebase graph database](http://www.freebase.com/).
50
-
51
68
*[WorldBank Provider](library/WorldBank.html) - discusses the `WorldBankData` type
52
69
and the `WorldBankDataProvider<..>` type
53
70
*[Freebase Provider](library/Freebase.html) - discusses the `FreebaseData` type
@@ -70,24 +87,32 @@ following topics:
70
87
### Tutorials
71
88
72
89
The above articles cover all key features of the F# Data library. However, if you're interested
73
-
in more samples or more details, then the following tutorials contain additional examples that use multiple different features together:
90
+
in more samples or more details, then the following tutorials contain additional examples that
91
+
use multiple different features together:
74
92
75
93
*[Converting between JSON and XML](tutorials/JsonToXml.html) - implements two serialization
76
94
functions that convert between the standard .NET `XElement` and the `JsonValue` from F# Data.
77
95
The tutorial demonstrates pattern matching on `JsonValue`.
78
-
79
96
*[Anonymizing JSON](tutorials/JsonAnonymizer.html) - implements a function to anonymize a `JsonValue` from F# Data.
80
97
The tutorial demonstrates pattern matching on `JsonValue`.
81
98
82
99
### Reference Documentation
83
100
84
-
There's also [reference documentation](reference) available. Please note that everything under the `FSharp.Data.Runtime` namespace is not considered as part of the public API and can change without notice.
101
+
There's also [reference documentation](reference) available. Please note that everything under
102
+
the `FSharp.Data.Runtime` namespace is not considered as part of the public API and can change without notice.
85
103
86
-
<br/><hr/>
104
+
Contributing and license
105
+
------------------------
87
106
88
-
# Contributing
107
+
The library is available under Apache 2.0. For more information see the
108
+
[License file][license] in the GitHub repository. In summary, this means that you can
109
+
use the library for commercial purposes, fork it, and modify it as you wish.
89
110
90
-
F# Data is made possible by the volunteer work [of more than a dozen contributors](https://github.com/fsharp/FSharp.Data/graphs/contributors) and we're open to contributions from anyone. If you want to help out but don't know where to start, you can take one of the [Up-For-Grabs](https://github.com/fsharp/FSharp.Data/issues?labels=up-for-grabs&state=open) issues, or help to improve the documentation.
111
+
F# Data is made possible by the volunteer work [of more than a dozen
112
+
contributors](https://github.com/fsharp/FSharp.Data/graphs/contributors) and we're open to
113
+
contributions from anyone. If you want to help out but don't know where to start, you
114
+
can take one of the [Up-For-Grabs](https://github.com/fsharp/FSharp.Data/issues?labels=up-for-grabs&state=open)
115
+
issues, or help to improve the documentation.
91
116
92
117
The project is hosted on [GitHub][gh] where you can [report issues][issues], fork
93
118
the project and submit pull requests. If you're adding new public API's, please also
0 commit comments