Please take a moment to review this document in order to make the contribution process easy and effective for everyone involved!
Use the issues tracker for:
Personal support request should be discussed on F# Software Foundation Slack.
A bug is either a demonstrable problem that is caused in Forge failing to provide the expected feature or indicate missing, unclear, or misleading documentation. Good bug reports are extremely helpful - thank you! ą Guidelines for bug reports:
-
Use the GitHub issue search — check if the issue has already been reported.
-
Check if the issue has been fixed — try to reproduce it using the
master
branch in the repository. -
Isolate and report the problem — ideally create a reduced test case.
Please try to be as detailed as possible in your report. Include information about
your Operating System, as well as your dotnet
. Please provide steps to
reproduce the issue as well as the outcome you were expecting! All these details
will help developers to fix any potential bugs.
Feature requests are welcome and should be discussed on issue tracker. But take a moment to find out whether your idea fits with the scope and aims of the project. It's up to you to make a strong case to convince the community of the merits of this feature. Please provide as much detail and context as possible.
Good pull requests - patches, improvements, new features - are a fantastic help. They should remain focused in scope and avoid containing unrelated commits.
IMPORTANT: By submitting a patch, you agree that your work will be licensed under the license used by the project.
If you have any large pull request in mind (e.g. implementing features, refactoring code, etc), please ask first otherwise you risk spending a lot of time working on something that the project's developers might not want to merge into the project.
Please adhere to the coding conventions in the project (indentation, accurate comments, etc.).
Fork, from the github interface https://github.com/ionide/forge
- if you don't use a certificate for committing to github:
git clone https://github.com/YOUR_GITHUB_USER/forge.git
- if you use a certificate for github authentication:
git clone [email protected]:YOUR_GITHUB_USER/forge.git
cd ionide-forge-fsharp
dotnet tool restore
dotnet fake build
If dotnet restore
gives the error error MSB4126: The specified solution configuration "Debug|x64" is invalid
, there's a good chance you have the Platform
environment variable set to "x64". Unset the variable and try the restore command again.
You can also build project from VSCode with Ctrl/Cmd + Shift + B
.
dotnet run --project src/Forge
fake build -t Test
Or
dotnet run --project tests/Forge.Tests
Debugging Forge or Forge.Tests is possible with VSCode - choose appropriate target in VSCode debug panel and press F5