From 1a437ddccc276c61ec03e0286a76408c91cfb9ae Mon Sep 17 00:00:00 2001 From: cartermp Date: Wed, 28 Feb 2018 15:46:18 -0800 Subject: [PATCH 01/13] Update to F# docs round 1 --- docs/fsharp/get-started/get-started-vscode.md | 6 +- docs/fsharp/index.md | 82 ++++++++++++------- docs/fsharp/tour.md | 7 -- 3 files changed, 57 insertions(+), 38 deletions(-) diff --git a/docs/fsharp/get-started/get-started-vscode.md b/docs/fsharp/get-started/get-started-vscode.md index d81d3bc281ab8..4bde7f7bdbe73 100644 --- a/docs/fsharp/get-started/get-started-vscode.md +++ b/docs/fsharp/get-started/get-started-vscode.md @@ -1,10 +1,10 @@ --- -title: Getting Started with F# in Visual Studio Code with Ionide +title: Getting Started with F# in Visual Studio Code description: Learn how to use F# with Visual Studio Code and the Ionide plugin suite. keywords: visual f#, f#, functional programming, .NET, Visual Studio Code, vscode, Ionide author: cartermp ms.author: phcart -ms.date: 09/28/2016 +ms.date: 02/21/2018 ms.topic: article ms.prod: .net ms.technology: devlang-fsharp @@ -12,7 +12,7 @@ ms.devlang: fsharp ms.assetid: 49775139-082e-442f-b5a2-dd402399b5d2 --- -# Getting Started with F# in Visual Studio Code with Ionide +# Geting Started with F# in Visual Studio Code You can write F# in [Visual Studio Code](https://code.visualstudio.com) with the [Ionide plugin](https://marketplace.visualstudio.com/items?itemName=Ionide.Ionide-fsharp), to get a great cross-platform, lightweight IDE experience with IntelliSense and basic code refactorings. Visit [Ionide.io](http://ionide.io) to learn more about the plugin suite. diff --git a/docs/fsharp/index.md b/docs/fsharp/index.md index 734e81b72d9fc..04db3c49d845b 100644 --- a/docs/fsharp/index.md +++ b/docs/fsharp/index.md @@ -1,10 +1,10 @@ --- title: F# Guide -description: Learn about F#, a functional programming language that runs on .NET. -keywords: .NET, .NET Core +description: Learn F#, a functional programming language that runs on .NET. +keywords: F#, .NET, .NET Core author: jackfoxy ms.author: phcart -ms.date: 12/01/2016 +ms.date: 02/21/2018 ms.topic: article ms.prod: .net ms.technology: devlang-fsharp @@ -14,45 +14,71 @@ 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 +[] +let main args = + args // Use F# pipe operators because they're awesome! + |> 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 // 0 return code +``` -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. See below to learn more. -## 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. Go here if you're interested in language concepts. -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 a the full Visual Studio IDE experience. + +[Get started with F# in Visual Studio for Mac](get-started/get-started-visual-studio-for-mac.md) if you're on macOS. + +[Get Started with F# in Visual Studio Code](get-started/get-started-vscode.md) if you want a lightweight and feature-packed IDE experience. + +[Get started with F# with the .NET Core CLI](get-started/get-started-command-line.md) if you just want a great set of 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, so check it out! -* [Tutorials](tutorials/getting-started/index.md) -* [Functions as First-Class Values](introduction-to-functional-programming/functions-as-first-class-values.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 wonderful wikibook on learning F#. It is also a product of the F# community. -## Online Reading Resources +## Learn F# by video -* [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. -## Video Learning Resources +[Introduction to Programming with F#](https://www.youtube.com/watch?v=Teak30_pXHk&list=PLEoMzSkcN8oNiJ67Hd7oRGgD1d4YBxYGC) is a great video series which uses Visual Studio Code as the main editor. The video series starts from nothing and ends with building a text-based RPG video game. -* [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 which shows some of the newer features for F# in Visual Studio 2017. -## 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]() + +* [F# Software Foundation](http://fsharp.org) + +## 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) \ No newline at end of file +To learn more and get involved, check out [fsharp.org](http://fsharp.org). It's 100% free to join, and the network of F# developers in the foundation is something you won't want to miss out on! \ No newline at end of file diff --git a/docs/fsharp/tour.md b/docs/fsharp/tour.md index 9cd572840ca2c..2dd07be9d167c 100644 --- a/docs/fsharp/tour.md +++ b/docs/fsharp/tour.md @@ -18,13 +18,6 @@ The best way to learn about F# is to read and write F# code. This article will There are two primary concepts in F#: functions and types. This tour will emphasize features of the language which fall into these two concepts. -## How to Run the Code Samples - ->[!NOTE] -Two options for running the code samples are [Try F#](http://www.tryfsharp.org/Create) (requires Silverlight) and [F# for Azure Notebooks](https://notebooks.azure.com/Microsoft/libraries/fsharp/html/FSharp%20for%20Azure%20Notebooks.ipynb) on Microsoft Azure. - -The quickest way to run these code samples is to use [F# Interactive](tutorials/fsharp-interactive/index.md). Just copy/paste the code samples and run them there. Alternatively you can set up a project to compile and run the code as a Console Application. See the [Get Started](./get-started/index.md) section to learn more. - ## Functions and Modules The most fundamental pieces of any F# program are ***functions*** organized into ***modules***. [Functions](language-reference/functions/index.md) perform work on inputs to produce outputs, and they are organized under [Modules](language-reference/modules.md), which are the primary way you group things in F#. They are defined using the [`let` binding](language-reference/functions/let-bindings.md), which give the function a name and define its arguments. From 0d511346fb9a2ebce3bb89af00b6eca9115e8894 Mon Sep 17 00:00:00 2001 From: cartermp Date: Wed, 28 Feb 2018 15:50:14 -0800 Subject: [PATCH 02/13] yup --- docs/fsharp/get-started/get-started-vscode.md | 4 ++-- docs/fsharp/index.md | 2 +- docs/fsharp/tour.md | 2 +- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/fsharp/get-started/get-started-vscode.md b/docs/fsharp/get-started/get-started-vscode.md index 4bde7f7bdbe73..6971a8b506a94 100644 --- a/docs/fsharp/get-started/get-started-vscode.md +++ b/docs/fsharp/get-started/get-started-vscode.md @@ -4,7 +4,7 @@ description: Learn how to use F# with Visual Studio Code and the Ionide plugin s keywords: visual f#, f#, functional programming, .NET, Visual Studio Code, vscode, Ionide author: cartermp ms.author: phcart -ms.date: 02/21/2018 +ms.date: 02/28/2018 ms.topic: article ms.prod: .net ms.technology: devlang-fsharp @@ -12,7 +12,7 @@ ms.devlang: fsharp ms.assetid: 49775139-082e-442f-b5a2-dd402399b5d2 --- -# Geting Started with F# in Visual Studio Code +# Get Started with F# in Visual Studio Code You can write F# in [Visual Studio Code](https://code.visualstudio.com) with the [Ionide plugin](https://marketplace.visualstudio.com/items?itemName=Ionide.Ionide-fsharp), to get a great cross-platform, lightweight IDE experience with IntelliSense and basic code refactorings. Visit [Ionide.io](http://ionide.io) to learn more about the plugin suite. diff --git a/docs/fsharp/index.md b/docs/fsharp/index.md index 04db3c49d845b..dd6bd9db8d4ef 100644 --- a/docs/fsharp/index.md +++ b/docs/fsharp/index.md @@ -4,7 +4,7 @@ description: Learn F#, a functional programming language that runs on .NET. keywords: F#, .NET, .NET Core author: jackfoxy ms.author: phcart -ms.date: 02/21/2018 +ms.date: 02/28/2018 ms.topic: article ms.prod: .net ms.technology: devlang-fsharp diff --git a/docs/fsharp/tour.md b/docs/fsharp/tour.md index 2dd07be9d167c..9ed3b5c1bce02 100644 --- a/docs/fsharp/tour.md +++ b/docs/fsharp/tour.md @@ -4,7 +4,7 @@ description: Examine some of the key features of the F# programming language in keywords: visual f#, f#, functional programming, .NET, tour author: cartermp ms.author: phcart -ms.date: 01/24/2017 +ms.date: 02/28/2018 ms.topic: article ms.prod: .net ms.technology: devlang-fsharp From 7fbf00f870887f559048cd93a3ac3700490e6326 Mon Sep 17 00:00:00 2001 From: cartermp Date: Wed, 28 Feb 2018 16:03:37 -0800 Subject: [PATCH 03/13] fix --- docs/fsharp/index.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/fsharp/index.md b/docs/fsharp/index.md index dd6bd9db8d4ef..b8d3cd2c3f335 100644 --- a/docs/fsharp/index.md +++ b/docs/fsharp/index.md @@ -55,7 +55,7 @@ F# is about productivity at its heart. The tooling support for F# is ubiquitous ## Additional guides -[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, so check it out! +[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. [F# Programming Wikibook](https://en.wikibooks.org/wiki/F_Sharp_Programming) is a wonderful wikibook on learning F#. It is also a product of the F# community. @@ -71,9 +71,9 @@ F# is about productivity at its heart. The tooling support for F# is ubiquitous 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]() +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. -* [F# Software Foundation](http://fsharp.org) +* [The F# Software Foundation](http://fsharp.org) has a mission 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. It's free to join, so we recommend it. ## The F# Software Foundation From aeebcf0f58bc3f06303cd3e12fd2655f939a3d9c Mon Sep 17 00:00:00 2001 From: cartermp Date: Wed, 28 Feb 2018 21:30:12 -0800 Subject: [PATCH 04/13] feedback --- docs/fsharp/get-started/get-started-vscode.md | 43 ++----------------- docs/fsharp/index.md | 17 +++----- 2 files changed, 10 insertions(+), 50 deletions(-) diff --git a/docs/fsharp/get-started/get-started-vscode.md b/docs/fsharp/get-started/get-started-vscode.md index 6971a8b506a94..5f3a8be3ba84d 100644 --- a/docs/fsharp/get-started/get-started-vscode.md +++ b/docs/fsharp/get-started/get-started-vscode.md @@ -1,5 +1,5 @@ --- -title: Getting Started with F# in Visual Studio Code +title: Get Started with F# in Visual Studio Code description: Learn how to use F# with Visual Studio Code and the Ionide plugin suite. keywords: visual f#, f#, functional programming, .NET, Visual Studio Code, vscode, Ionide author: cartermp @@ -18,48 +18,11 @@ You can write F# in [Visual Studio Code](https://code.visualstudio.com) with the ## Prerequisites -F# 4.0 or higher must be installed on your machine to use Ionide. - -You must also have [git installed](https://git-scm.com/download) and available on your PATH to make use of project templates in Ionide. You can verify that it is installed correctly by typing `git` at a command prompt.and pressing **Enter**. +You must have [git installed](https://git-scm.com/download) and available on your PATH to make use of project templates in Ionide. You can verify that it is installed correctly by typing `git` at a command prompt and pressing **Enter**. ### Windows -If you're on Windows, you have two options for installing F#. - -If you've already installed Visual Studio and don't have F#, you can [Install the Visual F# Tools](get-started-visual-studio.md#installing-f). This will install all the necessary components to write, compile, and execute F# code. - -If you prefer not to install Visual Studio, use the following instructions: - -1. Install [.NET Framework 4.5 or higher](https://www.microsoft.com/en-US/download/details.aspx?id=30653) if you're running Windows 7. If you're using Windows 8 or higher, you do not need to do this. - -2. Install the Windows SDK for your OS: - - * [Windows 10 SDK](https://dev.windows.com/en-US/downloads/windows-10-sdk) - * [Windows 8.1 SDK](http://msdn.microsoft.com/windows/desktop/bg162891) - * [Windows 8 SDK](http://msdn.microsoft.com/windows/hardware/hh852363.aspx) - * [Windows 7 SDK](http://www.microsoft.com/download/details.aspx?id=8279) - -3. Install the [Microsoft Build Tools 2015](https://www.microsoft.com/en-us/download/details.aspx?id=48159). You may also need to install [Microsoft Build Tools 2013](https://www.microsoft.com/en-us/download/details.aspx?id=40760). - -4. Install the [Visual F# Tools](https://www.microsoft.com/en-us/download/details.aspx?id=48179). - -On 64-bit Windows, the compiler and tools are located here: - -``` -C:\Program Files (x86)\Microsoft SDKs\F#\4.0\Framework\v4.0\fsc.exe -C:\Program Files (x86)\Microsoft SDKs\F#\4.0\Framework\v4.0\fsi.exe -C:\Program Files (x86)\Microsoft SDKs\F#\4.0\Framework\v4.0\fsiAnyCpu.exe -``` - -On 32-bit Windows, the compiler tools are located here: - -``` -C:\Program Files\Microsoft SDKs\F#\4.0\Framework\v4.0\fsc.exe -C:\Program Files\Microsoft SDKs\F#\4.0\Framework\v4.0\fsi.exe -C:\Program Files\Microsoft SDKs\F#\4.0\Framework\v4.0\fsiAnyCpu.exe -``` - -Ionide automatically detects the compiler and tools, but if it doesn't for some reason (for example, the Visual F# Tools were installed to a different directory), you can manually add the containing folder (`...\Microsoft SDKs\F#\4.0`) to your PATH. +If you're on Windows, you must [install Visual Studio with F# support](get-started-visual-studio.md#installing-f). This will install all the necessary components to write, compile, and execute F# code. ### macOS diff --git a/docs/fsharp/index.md b/docs/fsharp/index.md index b8d3cd2c3f335..70a5dba3d6c7b 100644 --- a/docs/fsharp/index.md +++ b/docs/fsharp/index.md @@ -1,7 +1,6 @@ --- title: F# Guide description: Learn F#, a functional programming language that runs on .NET. -keywords: F#, .NET, .NET Core author: jackfoxy ms.author: phcart ms.date: 02/28/2018 @@ -33,19 +32,19 @@ let main args = 0 // 0 return code ``` -F# is about productivity at its heart. The tooling support for F# is ubiquitous and full of advanced features. See below to learn more. +F# is about productivity at its heart. The tooling support for F# is ubiquitous and full of advanced features. ## Learning F# # -[Tour of F#](tour.md) gives an overview of major language features with lots of code samples. Go here if you're interested in language concepts. +[Tour of F#](tour.md) gives an overview of major language features with lots of code samples. Go here if you're interested in getting an overview of the language. -[Get started with F# in Visual Studio](get-started/get-started-visual-studio.md) if you're on Windows and want a the full Visual Studio IDE experience. +[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 experience. -[Get started with F# in Visual Studio for Mac](get-started/get-started-visual-studio-for-mac.md) if you're on macOS. +[Get started with F# in Visual Studio for Mac](get-started/get-started-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 and feature-packed IDE experience. +[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 just want a great set of command line tools. +[Get started with F# with the .NET Core CLI](get-started/get-started-command-line.md) if you just want a great set of command-line tools. ## References @@ -57,7 +56,7 @@ F# is about productivity at its heart. The tooling support for F# is ubiquitous [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. -[F# Programming Wikibook](https://en.wikibooks.org/wiki/F_Sharp_Programming) is a wonderful wikibook on learning F#. It is also a product of the F# community. +[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. ## Learn F# by video @@ -73,8 +72,6 @@ The [F# Snippets Website](http://www.fssnip.net) contains a massive set of code 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](http://fsharp.org) has a mission 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. It's free to join, so we recommend it. - ## 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). From f460a5c4758aaf1c67f699c998db17cdbe0ec85f Mon Sep 17 00:00:00 2001 From: cartermp Date: Thu, 1 Mar 2018 11:41:55 -0800 Subject: [PATCH 05/13] Fix link --- docs/fsharp/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/fsharp/index.md b/docs/fsharp/index.md index 70a5dba3d6c7b..041cb945242bb 100644 --- a/docs/fsharp/index.md +++ b/docs/fsharp/index.md @@ -40,7 +40,7 @@ F# is about productivity at its heart. The tooling support for F# is ubiquitous [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 experience. -[Get started with F# in Visual Studio for Mac](get-started/get-started-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 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. From fadd23bc5096460b696c0233ffe7cab64556d958 Mon Sep 17 00:00:00 2001 From: cartermp Date: Thu, 1 Mar 2018 12:42:47 -0800 Subject: [PATCH 06/13] feedback --- docs/fsharp/index.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/fsharp/index.md b/docs/fsharp/index.md index 041cb945242bb..9e8973eae6b80 100644 --- a/docs/fsharp/index.md +++ b/docs/fsharp/index.md @@ -1,6 +1,6 @@ --- title: F# Guide -description: Learn F#, a functional programming language that runs on .NET. +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: 02/28/2018 @@ -36,7 +36,7 @@ F# is about productivity at its heart. The tooling support for F# is ubiquitous ## Learning F# # -[Tour of F#](tour.md) gives an overview of major language features with lots of code samples. Go here if you're interested in getting an overview of the language. +[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. [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 experience. @@ -58,13 +58,13 @@ F# is about productivity at its heart. The tooling support for F# is ubiquitous [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. -## Learn F# by video +## Learn F# through videos [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. -[Introduction to Programming with F#](https://www.youtube.com/watch?v=Teak30_pXHk&list=PLEoMzSkcN8oNiJ67Hd7oRGgD1d4YBxYGC) is a great video series which uses Visual Studio Code as the main editor. The video series starts from nothing and ends with building a text-based RPG video game. +[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. -[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 which shows some of the newer features for F# in Visual Studio 2017. +[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. ## Other useful resources @@ -78,4 +78,4 @@ Although Microsoft is the primary developer of the F# language and its tools in 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. -To learn more and get involved, check out [fsharp.org](http://fsharp.org). It's 100% free to join, and the network of F# developers in the foundation is something you won't want to miss out on! \ No newline at end of file +To learn more and get involved, check out [fsharp.org](http://fsharp.org). It's 100% free to join, and the network of F# developers in the foundation is something you don't want to miss out on! \ No newline at end of file From b74a4ccebd5cf6bfdefdaa189ece2178238ad03c Mon Sep 17 00:00:00 2001 From: cartermp Date: Fri, 2 Mar 2018 07:19:15 -0800 Subject: [PATCH 07/13] Updates --- docs/fsharp/get-started/get-started-vscode.md | 26 +++++++++---------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/docs/fsharp/get-started/get-started-vscode.md b/docs/fsharp/get-started/get-started-vscode.md index 50baa512bc393..12f06e5469152 100644 --- a/docs/fsharp/get-started/get-started-vscode.md +++ b/docs/fsharp/get-started/get-started-vscode.md @@ -14,33 +14,33 @@ ms.assetid: 49775139-082e-442f-b5a2-dd402399b5d2 # Get Started with F# in Visual Studio Code -You can write F# in [Visual Studio Code](https://code.visualstudio.com) with the [Ionide plugin](https://marketplace.visualstudio.com/items?itemName=Ionide.Ionide-fsharp), to get a great cross-platform, lightweight IDE experience with IntelliSense and basic code refactorings. Visit [Ionide.io](https://ionide.io) to learn more about the plugin suite. +You can write F# in [Visual Studio Code](https://code.visualstudio.com) with the [Ionide plugin](https://marketplace.visualstudio.com/items?itemName=Ionide.Ionide-fsharp), to get a great cross-platform, lightweight IDE experience with IntelliSense and basic code refactorings. Visit [Ionide.io](http://ionide.io) to learn more about the plugin suite. ## Prerequisites You must have [git installed](https://git-scm.com/download) and available on your PATH to make use of project templates in Ionide. You can verify that it is installed correctly by typing `git` at a command prompt and pressing **Enter**. -### Windows +### [macOS](#tab/macos) -If you're on Windows, you must [install Visual Studio with F# support](get-started-visual-studio.md#installing-f). This will install all the necessary components to write, compile, and execute F# code. - -### macOS - -On macOS, Ionide uses [Mono](https://www.mono-project.com). The easiest way to install Mono on macOS is via Homebrew. Simply type the following into your terminal: +Ionide uses [Mono](http://www.mono-project.com). The easiest way to install Mono on macOS is via Homebrew. Simply type the following into your terminal: ``` brew install mono ``` -### Linux +### [Linux](#tab/linux) -On Linux, Ionide also uses [Mono](https://www.mono-project.com). If you're on Debian or Ubuntu, you can use the following: +On Linux, Ionide also uses [Mono](http://www.mono-project.com). If you're on Debian or Ubuntu, you can use the following: ``` sudo apt-get update sudo apt-get install mono-complete fsharp ``` +### [Windows](#tab/windows) + +If you're on Windows, you must [install Visual Studio with F# support](get-started-visual-studio.md#installing-f). This will install all the necessary components to write, compile, and execute F# code. + ## Installing Visual Studio Code and the Ionide plugin You can install Visual Studio Code from the [code.visualstudio.com](https://code.visualstudio.com) website. After that, there are two ways to find the Ionide plugin: @@ -55,7 +55,7 @@ You can install Visual Studio Code from the [code.visualstudio.com](https://code ![](media/getting-started-vscode/vscode-ext.png) -The only plugin required for F# support in Visual Studio Code is [Ionide-fsharp](https://marketplace.visualstudio.com/items?itemName=Ionide.Ionide-fsharp). However, you can also install [Ionide-FAKE](https://marketplace.visualstudio.com/items?itemName=Ionide.Ionide-FAKE) and to get [FAKE](https://fake.build/) support and [Ionide-Paket](https://marketplace.visualstudio.com/items?itemName=Ionide.Ionide-Paket) to get [Paket](https://fsprojects.github.io/Paket/) support. FAKE and Paket are additonal F# community tools for building projects and managing dependencies, respectively. +The only plugin required for F# support in Visual Studio Code is [Ionide-fsharp](https://marketplace.visualstudio.com/items?itemName=Ionide.Ionide-fsharp). However, you can also install [Ionide-FAKE](https://marketplace.visualstudio.com/items?itemName=Ionide.Ionide-FAKE) and to get [FAKE](http://fsharp.github.io/FAKE/) support and [Ionide-Paket](https://marketplace.visualstudio.com/items?itemName=Ionide.Ionide-Paket) to get [Paket](https://fsprojects.github.io/Paket/) support. FAKE and Paket are additonal F# community tools for building projects and managing dependencies, respectively. ## Creating your first project with Ionide @@ -80,7 +80,7 @@ Select "F#: New Project" by hitting **Enter**, which will take you to this step: ![](media/getting-started-vscode/vscode-proj-type.png) -This will select a template for a specific type of project. There are quite a few options here, such as an [FsLab](https://fslab.org) template for Data Science or [Suave](https://suave.io) template for Web Programming. This article uses the `classlib` template, so highlight that and hit **Enter**. You will then reach the following step: +This will select a template for a specific type of project. There are quite a few options here, such as an [FsLab](http://fslab.org) template for Data Science or [Suave](https://suave.io) template for Web Programming. This article uses the `classlib` template, so highlight that and hit **Enter**. You will then reach the following step: ![](media/getting-started-vscode/vscode-new-dir.png) @@ -97,8 +97,8 @@ If you followed the previous step steps, you should get the Visual Studio Code W This template generates a few things you'll find useful: 1. The F# project itself, underneath the `ClassLibraryDemo` folder. -2. The correct directory structure for adding packages via [`Paket`](https://fsprojects.github.io/Paket/). -3. A cross-platform build script with [`FAKE`](https://fake.build/). +2. The correct directory structure for adding packages via [`Paket`](http://fsprojects.github.io/Paket/). +3. A cross-platform build script with [`FAKE`](http://fsharp.github.io/FAKE/). 4. The `paket.exe` executable which can fetch packages and resolve dependencies for you. 5. A `.gitignore` file if you wish to add this project to Git-based source control. From 1b6e43b3137a1203e4056f288d0254fff3e13659 Mon Sep 17 00:00:00 2001 From: cartermp Date: Fri, 2 Mar 2018 07:28:17 -0800 Subject: [PATCH 08/13] Updates --- docs/fsharp/get-started/get-started-vscode.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/fsharp/get-started/get-started-vscode.md b/docs/fsharp/get-started/get-started-vscode.md index 12f06e5469152..5551dd9dc5686 100644 --- a/docs/fsharp/get-started/get-started-vscode.md +++ b/docs/fsharp/get-started/get-started-vscode.md @@ -39,7 +39,7 @@ sudo apt-get install mono-complete fsharp ### [Windows](#tab/windows) -If you're on Windows, you must [install Visual Studio with F# support](get-started-visual-studio.md#installing-f). This will install all the necessary components to write, compile, and execute F# code. +If you're on Windows, you must [install Visual Studio with F# support](get-started-visual-studio.md#installing-f). This installs all the necessary components to write, compile, and execute F# code. ## Installing Visual Studio Code and the Ionide plugin From e7cea2646920266da870c27bf4876b1b394a3c0a Mon Sep 17 00:00:00 2001 From: cartermp Date: Fri, 2 Mar 2018 10:27:32 -0800 Subject: [PATCH 09/13] Updates --- docs/fsharp/get-started/get-started-vscode.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/fsharp/get-started/get-started-vscode.md b/docs/fsharp/get-started/get-started-vscode.md index 5551dd9dc5686..21d5f10a019f9 100644 --- a/docs/fsharp/get-started/get-started-vscode.md +++ b/docs/fsharp/get-started/get-started-vscode.md @@ -41,6 +41,8 @@ sudo apt-get install mono-complete fsharp If you're on Windows, you must [install Visual Studio with F# support](get-started-visual-studio.md#installing-f). This installs all the necessary components to write, compile, and execute F# code. +--- + ## Installing Visual Studio Code and the Ionide plugin You can install Visual Studio Code from the [code.visualstudio.com](https://code.visualstudio.com) website. After that, there are two ways to find the Ionide plugin: From 5437c986845b860d8499da351f343f8143180a66 Mon Sep 17 00:00:00 2001 From: cartermp Date: Wed, 7 Mar 2018 16:49:42 -0800 Subject: [PATCH 10/13] Make comments betteR --- docs/fsharp/index.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/fsharp/index.md b/docs/fsharp/index.md index 9e8973eae6b80..6c2404f52b437 100644 --- a/docs/fsharp/index.md +++ b/docs/fsharp/index.md @@ -16,20 +16,20 @@ ms.assetid: ea27fb37-dad1-4bd4-a3cc-4f5c70767ae9 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. ```fsharp -open System // Get access to functionality in System namespace +open System // Get access to functionality in System namespace. -// Function: takes a name and produces a greeting +// Function: takes a name and produces a greeting. let getGreeting name = sprintf "Hello, %s! Isn't F# great?" name -// Use the EntryPoint attribute to run the program +// Use the EntryPoint attribute to run the program. [] let main args = - args // Use F# pipe operators because they're awesome! - |> Array.map getGreeting // Turn each name into a friendly greeting! - |> Array.iter printfn // Print them! + 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! - 0 // 0 return code + 0 ``` F# is about productivity at its heart. The tooling support for F# is ubiquitous and full of advanced features. From db9e2802778591089e37ce81991742d60e46b387 Mon Sep 17 00:00:00 2001 From: cartermp Date: Sat, 10 Mar 2018 06:37:29 -0800 Subject: [PATCH 11/13] Feedback --- docs/fsharp/get-started/get-started-vscode.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/docs/fsharp/get-started/get-started-vscode.md b/docs/fsharp/get-started/get-started-vscode.md index 21d5f10a019f9..c6a2ca5c89b67 100644 --- a/docs/fsharp/get-started/get-started-vscode.md +++ b/docs/fsharp/get-started/get-started-vscode.md @@ -28,6 +28,8 @@ Ionide uses [Mono](http://www.mono-project.com). The easiest way to install Mon brew install mono ``` +You must also install the [.NET Core SDK](https://www.microsoft.com/net/download/macos). + ### [Linux](#tab/linux) On Linux, Ionide also uses [Mono](http://www.mono-project.com). If you're on Debian or Ubuntu, you can use the following: @@ -37,10 +39,14 @@ sudo apt-get update sudo apt-get install mono-complete fsharp ``` +You must also install the [.NET Core SDK](https://www.microsoft.com/net/download/linux). + ### [Windows](#tab/windows) If you're on Windows, you must [install Visual Studio with F# support](get-started-visual-studio.md#installing-f). This installs all the necessary components to write, compile, and execute F# code. +You must also install the [.NET Core SDK](https://www.microsoft.com/net/download/windows/). + --- ## Installing Visual Studio Code and the Ionide plugin @@ -82,7 +88,7 @@ Select "F#: New Project" by hitting **Enter**, which will take you to this step: ![](media/getting-started-vscode/vscode-proj-type.png) -This will select a template for a specific type of project. There are quite a few options here, such as an [FsLab](http://fslab.org) template for Data Science or [Suave](https://suave.io) template for Web Programming. This article uses the `classlib` template, so highlight that and hit **Enter**. You will then reach the following step: +This will select a template for a specific type of project. There are quite a few options here, such as an [FsLab](https://fslab.org) template for Data Science or [Suave](https://suave.io) template for Web Programming. This article uses the `classlib` template, so highlight that and hit **Enter**. You will then reach the following step: ![](media/getting-started-vscode/vscode-new-dir.png) From 5f0e190487411d89c02210bd0a326a6174a0fa1f Mon Sep 17 00:00:00 2001 From: cartermp Date: Tue, 13 Mar 2018 20:35:04 -0700 Subject: [PATCH 12/13] Feedback --- docs/fsharp/get-started/get-started-vscode.md | 22 +++++++++---------- docs/fsharp/index.md | 12 +++++----- 2 files changed, 17 insertions(+), 17 deletions(-) diff --git a/docs/fsharp/get-started/get-started-vscode.md b/docs/fsharp/get-started/get-started-vscode.md index c6a2ca5c89b67..8cd40af07ce55 100644 --- a/docs/fsharp/get-started/get-started-vscode.md +++ b/docs/fsharp/get-started/get-started-vscode.md @@ -14,11 +14,11 @@ ms.assetid: 49775139-082e-442f-b5a2-dd402399b5d2 # Get Started with F# in Visual Studio Code -You can write F# in [Visual Studio Code](https://code.visualstudio.com) with the [Ionide plugin](https://marketplace.visualstudio.com/items?itemName=Ionide.Ionide-fsharp), to get a great cross-platform, lightweight IDE experience with IntelliSense and basic code refactorings. Visit [Ionide.io](http://ionide.io) to learn more about the plugin suite. +You can write F# in [Visual Studio Code](https://code.visualstudio.com) with the [Ionide plugin](https://marketplace.visualstudio.com/items?itemName=Ionide.Ionide-fsharp), to get a great cross-platform, lightweight IDE (Integrade Development Enivronment) experience with IntelliSense and basic code refactorings. Visit [Ionide.io](http://ionide.io) to learn more about the plugin suite. ## Prerequisites -You must have [git installed](https://git-scm.com/download) and available on your PATH to make use of project templates in Ionide. You can verify that it is installed correctly by typing `git` at a command prompt and pressing **Enter**. +You must have [git installed](https://git-scm.com/download) and available on your PATH to make use of project templates in Ionide. You can verify that it is installed correctly by typing `git --version` at a command prompt and pressing **Enter**. ### [macOS](#tab/macos) @@ -28,30 +28,30 @@ Ionide uses [Mono](http://www.mono-project.com). The easiest way to install Mon brew install mono ``` -You must also install the [.NET Core SDK](https://www.microsoft.com/net/download/macos). +You must also install the [.NET Core SDK](https://www.microsoft.com/net/download). ### [Linux](#tab/linux) -On Linux, Ionide also uses [Mono](http://www.mono-project.com). If you're on Debian or Ubuntu, you can use the following: +On Linux, Ionide also uses [Mono](https://www.mono-project.com). If you're on Debian or Ubuntu, you can use the following: ``` sudo apt-get update sudo apt-get install mono-complete fsharp ``` -You must also install the [.NET Core SDK](https://www.microsoft.com/net/download/linux). +You must also install the [.NET Core SDK](https://www.microsoft.com/net/download). ### [Windows](#tab/windows) -If you're on Windows, you must [install Visual Studio with F# support](get-started-visual-studio.md#installing-f). This installs all the necessary components to write, compile, and execute F# code. +If you're on Windows, you must [install Visual Studio with F# support](get-started-visual-studio.md#installing-f). This installs all the necessary components to write, compile, and execute F# code. -You must also install the [.NET Core SDK](https://www.microsoft.com/net/download/windows/). +You must also install the [.NET Core SDK](https://www.microsoft.com/net/download/). --- ## Installing Visual Studio Code and the Ionide plugin -You can install Visual Studio Code from the [code.visualstudio.com](https://code.visualstudio.com) website. After that, there are two ways to find the Ionide plugin: +You can install Visual Studio Code from the [code.visualstudio.com](https://code.visualstudio.com) website. After that, there are two ways to find the Ionide plugin: 1. Use the Command Palette (Ctrl+Shift+P on Windows, ⌘+Shift+P on macOS, Ctrl+Shift+P on Linux) and type the following: @@ -63,7 +63,7 @@ You can install Visual Studio Code from the [code.visualstudio.com](https://code ![](media/getting-started-vscode/vscode-ext.png) -The only plugin required for F# support in Visual Studio Code is [Ionide-fsharp](https://marketplace.visualstudio.com/items?itemName=Ionide.Ionide-fsharp). However, you can also install [Ionide-FAKE](https://marketplace.visualstudio.com/items?itemName=Ionide.Ionide-FAKE) and to get [FAKE](http://fsharp.github.io/FAKE/) support and [Ionide-Paket](https://marketplace.visualstudio.com/items?itemName=Ionide.Ionide-Paket) to get [Paket](https://fsprojects.github.io/Paket/) support. FAKE and Paket are additonal F# community tools for building projects and managing dependencies, respectively. +The only plugin required for F# support in Visual Studio Code is [Ionide-fsharp](https://marketplace.visualstudio.com/items?itemName=Ionide.Ionide-fsharp). However, you can also install [Ionide-FAKE](https://marketplace.visualstudio.com/items?itemName=Ionide.Ionide-FAKE) and to get [FAKE](https://fsharp.github.io/FAKE/) support and [Ionide-Paket](https://marketplace.visualstudio.com/items?itemName=Ionide.Ionide-Paket) to get [Paket](https://fsprojects.github.io/Paket/) support. FAKE and Paket are additonal F# community tools for building projects and managing dependencies, respectively. ## Creating your first project with Ionide @@ -105,8 +105,8 @@ If you followed the previous step steps, you should get the Visual Studio Code W This template generates a few things you'll find useful: 1. The F# project itself, underneath the `ClassLibraryDemo` folder. -2. The correct directory structure for adding packages via [`Paket`](http://fsprojects.github.io/Paket/). -3. A cross-platform build script with [`FAKE`](http://fsharp.github.io/FAKE/). +2. The correct directory structure for adding packages via [`Paket`](https://fsprojects.github.io/Paket/). +3. A cross-platform build script with [`FAKE`](https://fsharp.github.io/FAKE/). 4. The `paket.exe` executable which can fetch packages and resolve dependencies for you. 5. A `.gitignore` file if you wish to add this project to Git-based source control. diff --git a/docs/fsharp/index.md b/docs/fsharp/index.md index 6c2404f52b437..1e926706573b0 100644 --- a/docs/fsharp/index.md +++ b/docs/fsharp/index.md @@ -44,7 +44,7 @@ F# is about productivity at its heart. The tooling support for F# is ubiquitous [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 just want a great set of command-line tools. +[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 @@ -54,17 +54,17 @@ F# is about productivity at its heart. The tooling support for F# is ubiquitous ## Additional guides -[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. +[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. -[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. +[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. ## Learn F# through videos -[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. +[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#. -[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. +[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#. -[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. +[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#. ## Other useful resources From 130b495f61fa780d6e4203f229cf7c7e3d6cc6db Mon Sep 17 00:00:00 2001 From: cartermp Date: Tue, 13 Mar 2018 21:07:45 -0700 Subject: [PATCH 13/13] fixes --- docs/fsharp/index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/fsharp/index.md b/docs/fsharp/index.md index 1e926706573b0..ba366cd5aa402 100644 --- a/docs/fsharp/index.md +++ b/docs/fsharp/index.md @@ -38,7 +38,7 @@ F# is about productivity at its heart. The tooling support for F# is ubiquitous [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. -[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 experience. +[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. @@ -78,4 +78,4 @@ Although Microsoft is the primary developer of the F# language and its tools in 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. -To learn more and get involved, check out [fsharp.org](http://fsharp.org). It's 100% free to join, and the network of F# developers in the foundation is something you don't want to miss out on! \ No newline at end of file +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! \ No newline at end of file