review-1

Author: v-thpra

learn-pr/language/fsharp-first-steps/includes/1-introduction.md

@@ -1,4 +1,4 @@
-F# is an open-source, cross-platform programming language that makes it easy to write succinct, performant, robust, and practical code
+F# is an open-source, cross-platform programming language that makes it easy to write succinct, performant, robust, and practical code.
 
 With F#, you can build applications like:
 
@@ -16,10 +16,10 @@ With F#, you can build applications like:
 
 In this module, you'll:
 
-- Understand what makes F# a good language for building applications
+- Understand what makes F# a good language for building applications.
 - Write your first line of F# code.
 - Build your first F# console application.
 
 ## What is the main goal?
 
-By the end of this module, you'll be able to write F# code to print a message to a text console, like the Windows command prompt or Linux bash shell. These lines of code provide you with your first look at the F# syntax, and immediately provide invaluable insights into what makes F# a great programming language.
+By the end of this module, you're able to write F# code to print a message to a text console, like the Windows command prompt or Linux bash shell. These lines of code provide you with your first look at the F# syntax, and immediately provide invaluable insights into what makes F# a great programming language.

learn-pr/language/fsharp-first-steps/includes/2-what-is-fsharp.md

@@ -6,19 +6,19 @@ F# has numerous features that include:
 
 - **Lightweight syntax:** Write low-ceremony code and focus on the core logic of your application.
 - **Type inference and automatic generalization:** Use the compiler to get the benefits of a statically typed language without explicitly defining your types.
-- **Immutable by default:** Apply predictable & repeatable transformations to your data without worrying about side-effects.
-- **Powerful data types:** Represent complex data & model domains using tuples, records, and discriminated unions.
+- **Immutable by default:** Apply predictable and repeatable transformations to your data without worrying about side-effects.
+- **Powerful data types:** Represent complex data and model domains using tuples, records, and discriminated unions.
 - **Pattern matching:** Enforce correctness in your application's behavior using the compiler.
 - **Asynchronous programming:** Support for asynchronous workflows out of the box.
 
 ## Why F#?
 
-There are many language features and aspects of the F# language that make it easy to be productive when writing code:
+There are many language features and aspects of the F# language that makes it easy to be productive when writing code:
 
-- **Succinct:** You write less code with F#, and it's also expressed in a clear manner.
+- **Succinct:** You write less code with F#, and the code is expressed in a clear manner.
 - **Performant:** F# comes with built-in parallelism and concurrency. It also uses the fact that it's part of the .NET runtime to speed up things.
-- **Robust:**  There are language constructs that make the code fault tolerant and robust like immutable by default, null value management and more.
-- **Supports multiple programming paradigms:** F# lets you choose the patterns and practices most effective for solving problems by providing strong support for functional and object programming paradigms.
+- **Robust:** There are language constructs that make the code fault tolerant and robust, like immutable by default, null value management, and more.
+- **Support for multiple programming paradigms:** F# lets you choose the patterns and practices most effective for solving problems by providing strong support for functional and object programming paradigms.
 
 ### Succinct
 
@@ -36,16 +36,16 @@ As the demands on your application grow, writing scalable code to meet those dem
 
 ### Robust
 
-Writing code that's unreliable can be costly. When you develop applications, you want to make sure that they stand the test of time. F# helps you write robust code by making the expected outcomes predictable and reproducible. Using world-class tooling and libraries you can catch and handle those edge-cases before your users do.
+Writing code that's unreliable can be costly. When you develop applications, you want to make sure that they stand the test of time. F# helps you write robust code by making the expected outcomes predictable and reproducible. Using world-class tooling and libraries, you can catch and handle those edge-cases before your users do.
 
 - **Immutable by default**: Having immutability by default means you can process your data without changing the original data throughout the execution of your program. Therefore when applying changes to your data you have a high degree of certainty of the expected outcome making code simpler to reason about and test.
-- **Null value handling**: Errors in an application due to null values can be costly. As a result, code bases can often be riddled with code to check for and handle null values. In F#, you can use the `Option` type to safely handle scenarios where `null` values may arise.
+- **Null value handling**: Errors in an application due to null values can be costly. As a result, code bases can often be riddled with code to check for and handle null values. In F#, you can use the `Option` type to safely handle scenarios where `null` values might arise.
 - **Professional-grade tooling**: Use lightweight text editors such as Visual Studio Code or an IDE like Visual Studio.
 - **Works with .NET libraries**: The .NET ecosystem has a rich ecosystem of libraries. As a .NET language, F# can take advantage of those libraries and use them inside your applications.
 
 ### Supports multiple programming paradigms
 
-F# is about getting things done. With strong functional & object programming support, F# lets you choose which patterns and practices best solve your problem. Using its interactive programming & scripting environments, you can begin validating your ideas instantly.
+F# is about getting things done. With strong functional and object programming support, F# lets you choose which patterns and practices best solve your problem. Using its interactive programming and scripting environments, you can begin validating your ideas instantly.
 
-- **Strong functional & object programming support**: Regardless of the patterns you implement in your applications, with F# you don't have to choose because it provides strong support for both functional and object programming. 
+- **Strong functional & object programming support**: Regardless of the patterns you implement in your applications, with F# you don't have to choose because it provides strong support for both functional and object programming.
 - **Interactive programming**: F# via F# Interactive provides scripting capabilities. Instead of compiling your code inside an F# project, you can get started writing and evaluating your code logic interactively via the console or through script files. For more visual environments such as when building visualizations, you can use tools like .NET notebooks via .NET Interactive.