Docs: actualize the contributor guide

Author: ForNeVeR

.github/workflows/check-links.yml

@@ -17,4 +17,4 @@ jobs:
       - uses: actions/setup-dotnet@v4
         with:
           dotnet-version: 9.x
-      - run: dotnet fsi check-dead-links.fsx
+      - run: dotnet fsi scripts/check-dead-links.fsx

CONTRIBUTING.md

@@ -1,29 +1,37 @@
-# Contribution Guidelines
-
+Contribution Guidelines
+=======================
 Please ensure your pull request adheres to the following guidelines:
 
 * Please search previous suggestions before making a new one, as yours may be a duplicate.
 * Please make an individual pull request for each suggestion.
-* Use the following format: \[RESOURCE\]\(WEB-LINK\) - DESCRIPTION. [LICENCE]
+* Use the following format: \[RESOURCE\]\(WEB-LINK\) - DESCRIPTION.
 * Keep descriptions short and simple.
 * End all descriptions with a full stop/period.
 * Make sure your text editor is set to remove trailing whitespace.
 * Order projects alphabetically within each category.
 * Check your spelling and grammar.
 * New categories, or improvements to the existing categorisation are welcome.
 
-## Pull requests workflow
-
+Pull Requests Workflow
+----------------------
 Please, submit one pull requests with one link per PR. If you want to add several links, you should create PR for each links, unless all of the proposed projects are belong to the same category. Pull request should have meaningful description what this project do, why do you want to add it to the list and any other info which might be useful. This will help maintainers with the review process.
 
-## Quality standard
-
+Quality standard
+----------------
 To stay on the list, projects should follow these quality standards:
 
 * Generally useful to the community
 * Actively maintained (even if that just means acknowledging open issues when they arise)
 * Stable
 * Documented
 * Tests
+* For GitHub repositories, we currently have a soft limit of no less than 50 stars 
 
 Thank you for your suggestions!
+
+Scripts
+-------
+This repository includes a couple of scripts to help with the project maintaining.
+
+- `scripts/update-toc.fsx`: run this one manually when you need to rebuild the table of contents.
+- `scripts/check-dead-links.fsx`: this script runs on CI to ensure we have no dead links in our list.

check-dead-links.fsx scripts/check-dead-links.fsxcheck-dead-links.fsx renamed to scripts/check-dead-links.fsx

@@ -72,7 +72,7 @@ let isNonLocalLink(link: string) =
         eprintfn $"Error during parsing link {link}: {error.Message}"
         reraise()
 
-let readmeFilePath = Path.Combine(__SOURCE_DIRECTORY__, "README.md")
+let readmeFilePath = Path.Combine(__SOURCE_DIRECTORY__, "../README.md")
 
 let markdown = File.ReadAllText(readmeFilePath)
 let document = Markdown.Parse(markdown, trackTrivia = true)

update-toc.fsx scripts/update-toc.fsxupdate-toc.fsx renamed to scripts/update-toc.fsx

@@ -6,7 +6,7 @@ open System.IO
 open Markdig.Renderers.Roundtrip
 open Markdig.Syntax
 
-let readmeFilePath = Path.Combine(__SOURCE_DIRECTORY__, "README.md")
+let readmeFilePath = Path.Combine(__SOURCE_DIRECTORY__, "../README.md")
 
 let markdown = File.ReadAllText(readmeFilePath)
 let document = Markdown.Parse(markdown, trackTrivia = true)