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.
You will also need the latest .NET 7 SDK installed from here.
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 either FSharp.sln
or VisualFSharp.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, open FSharp.sln
in your editor of choice.
The Compiler Documentation is essential reading for any larger contributions to the F# compiler codebase and contains links to learning videos, architecture diagrams and other resources.
The same docs are also published as the The F# Compiler Guide. It also contains the public searchable docs for FSharp.Compiler.Service component.
See DEVGUIDE.md for more details on configurations for building the codebase. In practice, you only really need to run build.cmd
/build.sh
.
See TESTGUIDE.md for information about the various test suites in this codebase and how to run them individually.
The F# Documentation is the primary documentation for F#. The source for the content is here.
The F# Language Design Process is the fundamental design process for the language, from suggestions to completed RFCs. There are also tooling RFCs for some topics where cross-community co-operation and visibility is most useful.
The F# Language Specification is an in-depth description of the F# language. This is essential for understanding some behaviors of the F# compiler and some of the rules within the compiler codebase. For example, the order and way name resolution happens is specified here, which greatly impacts how the code in Name Resolutions works and why certain decisions are made.
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.
Per-build versions of our NuGet packages are available via this URL: https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet-tools/nuget/v3/index.json
These are the branches in use:
main
release/dev15.9
release/dev17.x
Evolution of the F# language and core library follows a process spanning two additional repositories. The process is as follows:
This project is subject to the MIT License. A copy of this license is in License.txt.
This project has adopted the Contributor Covenant code of conduct to clarify expected behavior in our community. You can read it at CODE_OF_CONDUCT.
Members of the F# Software Foundation are invited to the FSSF 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: