You are invited to help produce future releases of the F# language compiler, library, and tools. This repository enables development on Linux, macOS and Windows, along with some automated CI testing for these.
The F# Compiler and Tools are also mirrored in the corresponding repository of the F# Software Foundation.
Changes contributed here are eventually propagated to this repository and are included in all packagings of F# and open source F# editing tools. The process for doing this is explained in this guide by the F# Core Engineering Group. Currently, the F# community coordinates packaging other editions of F# for use on Linux, macOS, Android, iOS, and other platforms, and Microsoft coordinates packaging this repository as part of the Visual F# Tools.
For historical reasons this repository is called "visualfsharp" and currently also contains the Visual F# IDE Tools. The eventual plan is to split these repositories into "fsharp" and "visualfsharp".
| Ubuntu (Build) | Windows (Debug Build) | Windows (Release Tests 1) | Windows (Release Tests 2) | Windows (Release Tests 3) | |
|---|---|---|---|---|---|
| master | |||||
| dev15.5 | |||||
| dev15.6 | |||||
| dev15.7 |
To setup Visual Studio to use the latest nightly releases of the Visual F# Tools: https://blogs.msdn.microsoft.com/dotnet/2017/03/14/announcing-nightly-releases-for-the-visual-f-tools/
See DEVGUIDE.md and TESTGUIDE.md for details on build, development, and testing.
See CONTRIBUTING.md for general guidelines on the contribution process, also how we label issues and PRs
To contribute to the F# ecosystem more generally see the F# Software Foundation's Community Projects pages.
These are the branches in use:
-
master= Latest branch for OSS developers and nightly users.- 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 into https://github.com/fsharp/fsharp to form the basis of Mono releases
- Gets integrated into https://github.com/fsharp/FSharp.Compiler.Service to form the basis of FSharp.Compiler.Service releases
-
dev15.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 th corresponding Visual Studio release.
- Gets ingegrated back into master once the corresponding Visual Studio release is made.
- Used to build Visual F# Tool updates
-
The F# Compiler Technical Guide maintained by contributors to this repository. Please read and contribute to that guide.
This project is subject to the MIT License. A copy of this license can be found in License.txt at the root of this repo.
For typical installs of F#, see https://fsharp.org.
To setup Visual Studio to use the latest nightly releases of the Visual F# Tools:
If you wish to set up a Preview nightly atop Visual Studio preview builds, you can either download a VSIX Manually from here or set up a VSIX feed in visual studio from here.
To install F#, see https://fsharp.org.
To download the bits for the latest CI builds see these instructions. This includes and ZIPs containing the F# compiler and VSIX installers for the Visual F# IDE Tools.
If you wish to use the latest F# compiler on a computer without Visual Studio 2017 installed, you can add the nuget package FSharp.Compiler.Tools to your projects. This will replace the in-box compiler with the version contained in the package.
The actual package is built in https://github.com/fsharp/fsharp.
You will need to adjust the targets reference on your project file to use the targets file from the installed FSharp.Compiler.Tools package.
See fsharp/fsharp#676 for how to modify your project file.
This project has adopted the code of conduct defined by the Contributor Covenant to clarify expected behavior in our community. This code of conduct has been adopted by many other projects. For more information see the Code of conduct.
Follow @VisualFSharp and @fsharporg on twitter and subscribe to the .NET Blog.
Members of the F# Software Foundation can be invited to the "F# Software Foundation" discussion rooms on slack. More details at https://fsharp.org/guides/slack/.