[Concept]: Basics #366

glaxxie · 2024-04-09T22:25:34Z

Basics for PowerShell : short history, introductions
Concept exercise : classic lasagna exercise
Extra: eternal links for related concepts mentioned

- Basics for PowerShell : short history, introductions - Concept exercise : classic lasagna exercise - Extra: eternal links for related concepted mentioned

IsaacG

How much English nit picking and wording suggestions do you want?

IsaacG · 2024-04-09T23:16:22Z

concepts/basics/.meta/config.json

@@ -0,0 +1,5 @@
+{
+    "blurb": "PowerShell is a task automation and configuration management program from Microsoft, consisting of a command-line shell and the associated scripting language.",


I've never heard a shell described this way before

Oh I lift this one straight from Wikipedia for a quick blurb 😆

IsaacG · 2024-04-09T23:17:49Z

concepts/basics/about.md

+
+### Constants
+
+Constants in PowerShell are read-only variables that can't be **removed** after defined.


This implies they can have their value changed, just not removed.

I thought the read-only mention already addressed that? But yeah I could change the wording here

IsaacG · 2024-04-09T23:18:18Z

concepts/basics/about.md

+## Functions
+
+Functions in PowerShell are defined using the `function` keyword.
+Each function can have zero or more formal parameters in `()` parenthesis, followed by its own scope start  with `{` and end with `}`. 


Suggested change

Each function can have zero or more formal parameters in `()` parenthesis, followed by its own scope start with `{` and end with `}`.

Each function can have zero or more formal parameters in `()` parenthesis, followed by its own scope start with `{` and end with `}`.

IsaacG · 2024-04-09T23:21:39Z

exercises/concepts/jeffrey-juicy-lasagna/.meta/design.md

+
+`basics`:
+
+- function definition & `return` keyword


Suggested change

- function definition & `return` keyword

- function definition and `return` keyword

IsaacG · 2024-04-09T23:22:28Z

exercises/concepts/jeffrey-juicy-lasagna/.meta/design.md

+- single line comments
+- updating variable values
+- using functions
+- variables, variable assignment, & variable naming


Suggested change

- variables, variable assignment, & variable naming

- variables, variable assignment and variable naming

Use of the Oxford comma should be consistent

BethanyG

Excellent work! I've left suggestions/comments mostly on the about.md file, with the same comments applying to where about.md overlaps with the introduction.md files. Most of these are suggestions - so if they don't sound or feel right to you, please feel free to ignore them. Except for the change from Python --> Powershell in the config.json. 😉 That you probably want to make. 😄

BethanyG · 2024-04-09T23:15:51Z

concepts/basics/about.md

@@ -0,0 +1,88 @@
+# About
+
+PowerShell is a dynamically implicit typed (also support strongly typed variables) scripting language from Microsoft, mostly focus on task automation and confifuration management.


Suggested change

PowerShell is a dynamically implicit typed (also support strongly typed variables) scripting language from Microsoft, mostly focus on task automation and confifuration management.

PowerShell is a dynamic and implicitly typed (_but also supporting [strongly typed][strong typed] variables_) scripting language from Microsoft, mostly focused on task automation and configuration management.

BethanyG · 2024-04-09T23:16:31Z

concepts/basics/about.md

+
+PowerShell is a dynamically implicit typed (also support strongly typed variables) scripting language from Microsoft, mostly focus on task automation and confifuration management.
+
+PowerShell supports imperative, functional, object-oriented programming, and even pipeline style.


Suggested change

PowerShell supports imperative, functional, object-oriented programming, and even pipeline style.

PowerShell supports imperative, functional, object-oriented, and even pipeline style programming.

BethanyG · 2024-04-09T23:17:04Z

concepts/basics/about.md

+PowerShell supports imperative, functional, object-oriented programming, and even pipeline style.
+
+PowerShell was built on the .NET platform and first released in 2006.
+It has been included by default in all modern Windows OS, and can be installed on Mac and Linux.


Suggested change

It has been included by default in all modern Windows OS, and can be installed on Mac and Linux.

It has been included by default in all modern Windows OS, and can also be installed on Mac and Linux.

BethanyG · 2024-04-09T23:18:18Z

concepts/basics/about.md

+
+There are two common ways to define a variable in PowerShell.
+
+Varible name in PowerShell must start with `$` and using the assignment operator `=` to bind the variable name to a value.


Suggested change

Varible name in PowerShell must start with `$` and using the assignment operator `=` to bind the variable name to a value.

Variable names in PowerShell must start with a `$`, and use the assignment operator `=` to bind the variable name to a value.

BethanyG · 2024-04-09T23:20:35Z

concepts/basics/about.md

+System.Double
+```
+
+You can also explicitly specify a variable's type if you want to enforce a specific type.


Suggested change

You can also explicitly specify a variable's type if you want to enforce a specific type.

You can also specify a variable's type explicitly, if you want to enforce/require the value be of a certain type.

BethanyG · 2024-04-09T23:29:49Z

exercises/concepts/jeffrey-juicy-lasagna/.docs/hints.md

+## 1. Define constant expected bake time in minutes
+
+- You need to define a constant variable, and assign it an integer value.
+- Constant can be defined through [New-Variable cmdlet][new variable].


Suggested change

- Constant can be defined through [New-Variable cmdlet][new variable].

- Constants can be defined through the [New-Variable cmdlet][new variable].

BethanyG · 2024-04-09T23:30:16Z

concepts/basics/about.md

+
+### Constants
+
+Constants in PowerShell are read-only variables that can't be **removed** after defined.


Suggested change

Constants in PowerShell are read-only variables that can't be **removed** after defined.

Constants in PowerShell are read-only variables that can't be **removed** after definition.

BethanyG · 2024-04-09T23:30:51Z

concepts/basics/about.md

+### Constants
+
+Constants in PowerShell are read-only variables that can't be **removed** after defined.
+This lead us to the second way to define variables using the cmdlet `New-Variable`.


Suggested change

This lead us to the second way to define variables using the cmdlet `New-Variable`.

This leads us to the second way of defining variables: using the cmdlet `New-Variable`.

BethanyG · 2024-04-09T23:35:53Z

exercises/concepts/jeffrey-juicy-lasagna/.meta/config.json

+      "python/guidos-gorgeous-lasagna"
+    ],
+    "icon": "lasagna",
+    "blurb": "Learn the basics of Python by making lasagna."


Suggested change

"blurb": "Learn the basics of Python by making lasagna."

"blurb": "Learn the basics of Powershell by making lasagna."

BethanyG · 2024-04-09T23:37:03Z

exercises/concepts/jeffrey-juicy-lasagna/.meta/design.md

+- Know how to add one or more `parameters` to a function definition.
+- Know that `parameters` definitions can have type annotations.


I didn't see either of these in the exercise instructions, but maybe in the links?

Oh yeah, that 2nd part should be moved to the advanced function concept.

Changes made multiple files regarding the wording based on feedback

Add "basics" slug to concepts array

ErikSchierboom

Really nice!

[Concept]: Basics

38002d2

- Basics for PowerShell : short history, introductions - Concept exercise : classic lasagna exercise - Extra: eternal links for related concepted mentioned

glaxxie added Work In Progress When assigned to someone... (Work In Progress->Need Code Review->Ready for Master) x:module/concept Work on Concepts x:module/concept-exercise Work on Concept Exercises labels Apr 9, 2024

IsaacG reviewed Apr 9, 2024

View reviewed changes

BethanyG approved these changes Apr 9, 2024

View reviewed changes

glaxxie added 2 commits April 14, 2024 21:20

Fixed wording and folder names

c48a6ee

Changes made multiple files regarding the wording based on feedback

Update config.json

9dbc1cc

Add "basics" slug to concepts array

glaxxie requested review from ErikSchierboom and meatball133 April 16, 2024 22:01

ErikSchierboom approved these changes Apr 17, 2024

View reviewed changes

glaxxie removed the Work In Progress When assigned to someone... (Work In Progress->Need Code Review->Ready for Master) label Apr 17, 2024

glaxxie merged commit 631560b into exercism:main Apr 17, 2024
3 checks passed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[Concept]: Basics #366

[Concept]: Basics #366

glaxxie commented Apr 9, 2024

IsaacG left a comment

IsaacG Apr 9, 2024

glaxxie Apr 10, 2024

IsaacG Apr 9, 2024

glaxxie Apr 10, 2024

IsaacG Apr 9, 2024

IsaacG Apr 9, 2024

IsaacG Apr 9, 2024

BethanyG left a comment

BethanyG Apr 9, 2024

BethanyG Apr 9, 2024

BethanyG Apr 9, 2024

BethanyG Apr 9, 2024

BethanyG Apr 9, 2024

BethanyG Apr 9, 2024

BethanyG Apr 9, 2024

BethanyG Apr 9, 2024

BethanyG Apr 9, 2024

BethanyG Apr 9, 2024

glaxxie Apr 10, 2024

ErikSchierboom left a comment

		@@ -0,0 +1,5 @@
		{
		"blurb": "PowerShell is a task automation and configuration management program from Microsoft, consisting of a command-line shell and the associated scripting language.",


		### Constants

		Constants in PowerShell are read-only variables that can't be removed after defined.

	Each function can have zero or more formal parameters in `()` parenthesis, followed by its own scope start with `{` and end with `}`.
	Each function can have zero or more formal parameters in `()` parenthesis, followed by its own scope start with `{` and end with `}`.

	- function definition & `return` keyword
	- function definition and `return` keyword

	- variables, variable assignment, & variable naming
	- variables, variable assignment and variable naming

		@@ -0,0 +1,88 @@
		# About

		PowerShell is a dynamically implicit typed (also support strongly typed variables) scripting language from Microsoft, mostly focus on task automation and confifuration management.

	PowerShell is a dynamically implicit typed (also support strongly typed variables) scripting language from Microsoft, mostly focus on task automation and confifuration management.
	PowerShell is a dynamic and implicitly typed (_but also supporting [strongly typed][strong typed] variables_) scripting language from Microsoft, mostly focused on task automation and configuration management.


		PowerShell is a dynamically implicit typed (also support strongly typed variables) scripting language from Microsoft, mostly focus on task automation and confifuration management.

		PowerShell supports imperative, functional, object-oriented programming, and even pipeline style.

	It has been included by default in all modern Windows OS, and can be installed on Mac and Linux.
	It has been included by default in all modern Windows OS, and can also be installed on Mac and Linux.


		There are two common ways to define a variable in PowerShell.

		Varible name in PowerShell must start with `$` and using the assignment operator `=` to bind the variable name to a value.

	Varible name in PowerShell must start with `$` and using the assignment operator `=` to bind the variable name to a value.
	Variable names in PowerShell must start with a `$`, and use the assignment operator `=` to bind the variable name to a value.

	You can also explicitly specify a variable's type if you want to enforce a specific type.
	You can also specify a variable's type explicitly, if you want to enforce/require the value be of a certain type.

	- Constant can be defined through [New-Variable cmdlet][new variable].
	- Constants can be defined through the [New-Variable cmdlet][new variable].

	This lead us to the second way to define variables using the cmdlet `New-Variable`.
	This leads us to the second way of defining variables: using the cmdlet `New-Variable`.

	"blurb": "Learn the basics of Python by making lasagna."
	"blurb": "Learn the basics of Powershell by making lasagna."

		- Know how to add one or more `parameters` to a function definition.
		- Know that `parameters` definitions can have type annotations.

[Concept]: Basics #366

[Concept]: Basics #366

Conversation

glaxxie commented Apr 9, 2024

IsaacG left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

BethanyG left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

ErikSchierboom left a comment

Choose a reason for hiding this comment