Repository files navigation

You're invited to contribute to future releases of the F# compiler, core library, and tools. Development of this repository can be done on any OS supported by.NET Core.

Build from the command line:

build.cmd

The build depends on an installation of Visual Studio. To build the compiler without this dependency use:

build.cmd -noVisualStudio

After it's finished, open eitherFSharp.sln orVisualFSharp.sln in your editor of choice. The latter solution is larger but includes the F# tools for Visual Studio and its associated infrastructure.

Build from the command line:

./build.sh

After it's finished, openFSharp.sln in your editor of choice.

If you'd like to use Visual Studio online (or VSCode with VSO as backend), just click this button to create a new online environment:

This will provision an environment with all necessary dependencies. Initial build of the environment may take up to 10 minutes, as it's also performing initial build of the F# compiler.

SeeDEVGUIDE.md andTESTGUIDE.md for more details on additional configurations for building and testing, how to update compiler error messages, and more.

Even if you find a single-character typo, we're happy to take the change! Although the codebase can feel daunting for beginners, we and other contributors are happy to help you along.

Branch	Status
master

You can use the latestmaster build of the F# compiler and tools for Visual Studio via our nightly releases if you are a Visual Studio user. See details on setup here:

https://blogs.msdn.microsoft.com/dotnet/2017/03/14/announcing-nightly-releases-for-the-visual-f-tools/

Alternatively, if youreally want to live on the bleeding edge, you can set up a nightly feed for the Visual Studio preview releases, which use the latest commit in the preview branch. To do so, follow the same instructions as the above blog post, but instead with these links:

• Set your feed to the preview feed:https://dotnet.myget.org/F/fsharp-preview/vsix
• Install a VSIX manually from the preview feed:https://dotnet.myget.org/feed/fsharp-preview/package/vsix/VisualFSharp

These are the branches in use:

• master

  • Most contributions go here.
  • Able to be built, installed and used in the latest public Visual Studio release.
  • May contain updated F# features and logic.
  • Used to build nightly VSIX (see above).
  • Gets integrated intohttps://github.com/fsharp/fsharp to form the basis of Mono releases
  • Gets integrated intohttps://github.com/fsharp/FSharp.Compiler.Service to form the basis of FSharp.Compiler.Service releases

• dev15.9

  • Long-term servicing branch for VS 2017 update 15.9.x. We do not expect to service that release, but if we do, that's where the changes will go.

• dev16.x

  • Latest release branch for the particular point release of Visual Studio.
  • Incorporates features and fixes from master up to a particular branch point, then selective cherry-picks.
  • May contain new features that depend on new things or fixes in the corresponding forthcoming Visual Studio release.
  • Gets integrated back into master once the corresponding Visual Studio release is made.

Evolution of the F# language and core library follows a process spanning two additional repositories. The process is as follows:

1. Use theF# language suggestions repo to search for ideas, vote on ones you like, submit new ideas, and discuss details with the F# community.
2. Ideas that are "approved in principle" are eligible for a new RFC in theF# language design repo. This is where the technical specification and discussion of approved suggestions go.
3. Implementations and testing of an RFC are submitted to this repository.

The following links can help you get an overview of some technical aspects of the F# language and compiler:

• The F# Compiler Technical Guide
• The F# Language Specification

This project is subject to the MIT License. A copy of this license is inLicense.txt.

This project has adopted theContributor Covenant code of conduct to clarify expected behavior in our community. You can read it atCODE_OF_CONDUCT.

Members of theF# Software Foundation are invited to theFSSF Slack. You can find support from other contributors in the#compiler and#editor-support channels.

Additionally, you can use the#fsharp tag on Twitter if you have general F# questions, including about this repository. Chances are you'll get multiple responses.

If you're curious about F# itself, check out these links:

• What is F#
• Get started with F#
• F# Software Foundation
• F# Testimonials