Repository navigation
Update the F# Guide page and some ms.date links #4521
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Changes from all commits
1a437dd
0d51134
7fbf00f
aeebcf0
a0fcbde
f460a5c
fadd23b
b74a4cc
1b6e43b
e7cea26
5437c98
db9e280
5f0e190
130b495
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,10 +1,9 @@ | ||
| --- | ||
| title: F# Guide | ||
| description: Learn about F#, a functional programming language that runs on .NET. | ||
| keywords: .NET, .NET Core | ||
| description: This guide provides an overview of various learning materials for F#, a functional programming language that runs on .NET. | ||
| author: jackfoxy | ||
| ms.author: phcart | ||
| ms.date: 12/01/2016 | ||
| ms.date: 02/28/2018 | ||
| ms.topic: article | ||
| ms.prod: .net | ||
| ms.technology: devlang-fsharp | ||
|
|
@@ -14,45 +13,69 @@ ms.assetid: ea27fb37-dad1-4bd4-a3cc-4f5c70767ae9 | |
|
|
||
| # F# Guide | ||
|
|
||
| F# is a functional programming language which runs on .NET. In addition to supporting functional programming constructs, it also has object programming capabilities. This hybrid of functional programming with object-oriented capabilities makes F# a pragmatic language for accomplishing any task. | ||
| F# is a functional programming language that runs on .NET. It also has full support for objects, letting you blend functional and object programming for pragmatic solutions to any problem. | ||
|
|
||
| ## If You're New to F# # | ||
| ```fsharp | ||
| open System // Get access to functionality in System namespace. | ||
|
|
||
| If you're new to F#, begin with the [Tour of F#](tour.md) to get an overview of the language and some of its programming concepts. If you're using Visual Studio, the Tutorial project template contains the same content. | ||
| // Function: takes a name and produces a greeting. | ||
| let getGreeting name = | ||
| sprintf "Hello, %s! Isn't F# great?" name | ||
|
|
||
| ## If You're Experienced with F# # | ||
| // Use the EntryPoint attribute to run the program. | ||
| [<EntryPoint>] | ||
| let main args = | ||
| args // Use F# pipe operators to send the args into some functions. | ||
| |> Array.map getGreeting // Turn each name into a friendly greeting. | ||
| |> Array.iter printfn // Print them! | ||
|
|
||
| If you know your way around F#, or want to learn more about a specific language construct, see the [Language Reference](language-reference/index.md). It's a thorough guide of all F# language capabilities. | ||
| 0 | ||
| ``` | ||
|
|
||
| Additionally, the [F# Core Library Reference](https://msdn.microsoft.com/visualfsharpdocs/conceptual/fsharp-core-library-reference) is a great resource for learning about FSharp.Core, the core library which is a part of F#. | ||
| F# is about productivity at its heart. The tooling support for F# is ubiquitous and full of advanced features. | ||
|
|
||
| ## The F# Software Foundation | ||
| ## Learning F# # | ||
|
|
||
| Although Microsoft is the primary developer of the F# language and its tooling, F# is also backed by an independent foundation, the F# Software Foundation (FSSF). | ||
| [Tour of F#](tour.md) gives an overview of major language features with lots of code samples. This is recommended if you are new to F# and want to get a feel for how the language works. | ||
|
Member
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Would the tour also be useful for new developers? If not, is there a new programmers introduction to F#?
Contributor
Author
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Perhaps, but most of the data I've seen about FP indicates that it's not something new programmers get into. Not until it's taught in beginner courses in university, at least.
Member
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. That makes sense. I think the important point is to identify the audience so they can self-select the right locationn. |
||
|
|
||
| The mission of the F# Software Foundation is to promote, protect, and advance the F# programming language, and to support and facilitate the growth of a diverse and international community of F# programmers. | ||
| [Get started with F# in Visual Studio](get-started/get-started-visual-studio.md) if you're on Windows and want the full Visual Studio IDE (Integraded Development Environment) experience. | ||
|
|
||
| [Get started with F# in Visual Studio for Mac](get-started/get-started-with-visual-studio-for-mac.md) if you're on macOS and want to use a Visual Studio IDE. | ||
|
|
||
| [Get Started with F# in Visual Studio Code](get-started/get-started-vscode.md) if you want a lightweight, cross-platform, and feature-packed IDE experience. | ||
|
|
||
| [Get started with F# with the .NET Core CLI](get-started/get-started-command-line.md) if you want to use command-line tools. | ||
|
|
||
| ## References | ||
|
|
||
| [F# Language Reference](language-reference/index.md) is the official, comprehensive reference for all F# language features. Each article explains the syntax and shows code samples. You can use the filter bar in the table of contents to find specific articles. | ||
|
|
||
| [F# Core Library Reference](https://msdn.microsoft.com/visualfsharpdocs/conceptual/fsharp-core-library-reference) is the API reference for the F# Core Library. | ||
|
|
||
| To learn more and get involved, check out [fsharp.org](http://fsharp.org). | ||
| ## Additional guides | ||
|
|
||
| ## Documentation | ||
| [F# for Fun and Profit](https://swlaschin.gitbooks.io/fsharpforfunandprofit/content/) is a comprehensive and very detailed book on learning F#. Its contents and author are beloved by the F# community. The target audience is primarily developers with an object oriented programming background. | ||
|
|
||
| * [Tutorials](tutorials/getting-started/index.md) | ||
| * [Functions as First-Class Values](introduction-to-functional-programming/functions-as-first-class-values.md)<!--[Introduction to Functional Programming](introduction-to-functional-programming/index.md)--> | ||
| * [Language Reference](language-reference/index.md) | ||
| * [F# Core Library Reference](https://msdn.microsoft.com/visualfsharpdocs/conceptual/fsharp-core-library-reference) | ||
| [F# Programming Wikibook](https://en.wikibooks.org/wiki/F_Sharp_Programming) is a wikibook about learning F#. It is also a product of the F# community. The target audience is people who are new to F#, with a little bit of object oriented programming background. | ||
|
|
||
| ## Online Reading Resources | ||
| ## Learn F# through videos | ||
|
|
||
| * [F# for Fun and Profit Gitbook](https://swlaschin.gitbooks.io/fsharpforfunandprofit/content/) | ||
| * [F# Programming Wikibook](https://en.wikibooks.org/wiki/F_Sharp_Programming) | ||
| [F# tutorial on YouTube](https://www.youtube.com/watch?v=c7eNDJN758U) is a great introduction to F# using Visual Studio, showing lots of great examples over the course of 1.5 hours. The target audience is Visual Studio developers who are new to F#. | ||
|
|
||
| ## Video Learning Resources | ||
| [Introduction to Programming with F#](https://www.youtube.com/watch?v=Teak30_pXHk&list=PLEoMzSkcN8oNiJ67Hd7oRGgD1d4YBxYGC) is a great video series that uses Visual Studio Code as the main editor. The video series starts from nothing and ends with building a text-based RPG video game. The target audience is developers who prefer Visual Studio Code (or a lightweight IDE) and are new to F#. | ||
|
|
||
| * [Introduction to Programming with F# series on YouTube](https://www.youtube.com/watch?v=Teak30_pXHk&list=PLEoMzSkcN8oNiJ67Hd7oRGgD1d4YBxYGC) | ||
| * [Introduction to F# series on FSharpTV](https://fsharp.tv/courses/fsharp-programming-intro/) | ||
| [What's New in Visual Studio 2017 for F# For Developers](https://www.linkedin.com/learning/what-s-new-in-visual-studio-2017-for-f-sharp-for-developers) is a video course that shows some of the newer features for F# in Visual Studio 2017. The target audience is Visual Studio developers who are new to F#. | ||
|
|
||
| ## Further Resources | ||
| ## Other useful resources | ||
|
|
||
| The [F# Snippets Website](http://www.fssnip.net) contains a massive set of code snippets showing how to do just about anything in F#, ranging from absolute beginner to highly advanced snippets. | ||
|
|
||
| The [F# Software Foundation Slack](http://fsharp.org/guides/slack/) is a great place for beginners and experts alike, is highly active, and has some of world's best F# programmers available for a chat. We highly recommend joining. | ||
|
|
||
| ## The F# Software Foundation | ||
|
|
||
| Although Microsoft is the primary developer of the F# language and its tools in Visual Studio, F# is also backed by an independent foundation, the F# Software Foundation (FSSF). | ||
|
|
||
| The mission of the F# Software Foundation is to promote, protect, and advance the F# programming language, and to support and facilitate the growth of a diverse and international community of F# programmers. | ||
|
|
||
| * [F# Learning Resources on fsharp.org](http://fsharp.org/learn.html) | ||
| * [F# Snippets Website](http://www.fssnip.net) | ||
| * [F# Software Foundation](http://fsharp.org) | ||
| To learn more and get involved, check out [fsharp.org](http://fsharp.org). It's free to join, and the network of F# developers in the foundation is something you don't want to miss out on! | ||
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Some comments on this topic suggest that the article should be updated to 4.1 and that you don't need Mono on Mac. Make sure that the article is still accurate before changing the date.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Re: 4.1 - I'm actually just going to remove that section. It's confusing, and the standalone install of F# atop Windows is something very few people do.
Re: Mono - still untrue, unfortunately. The .NET Core-only Ionide experience is still experimental.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Sounds good @cartermp!