puppet: update page (#18581)

* add more instructions to puppet.md page

* resolve 4 of 4 review comments

* replace noop acronym with full form

pages/common/puppet.md

@@ -1,21 +1,34 @@
 # puppet
 
-> Help to manage and automate the configuration of servers.
-> Some subcommands such as `agent` have their own usage documentation.
+> Manage and automate the configuration of servers.
+> Puppet uses a declarative language to define system configurations and apply them automatically.
+> Some subcommands, such as `agent` and `apply`, have their own usage documentation.
 > More information: <https://github.com/puppetlabs/puppet/blob/main/references/man/overview.md>.
 
-- Execute a Puppet subcommand:
+- Apply a Puppet manifest file to configure the system:
 
-`puppet {{subcommand}}`
+`puppet apply {{path/to/file.pp}}`
 
-- Display help:
+- Apply a manifest in no operation (dry-run) mode to preview changes:
 
-`puppet --help`
+`puppet apply --noop {{path/to/file.pp}}`
 
-- Display help for a subcommand:
+- Validate the syntax of a Puppet manifest:
+
+`puppet parser validate {{path/to/file.pp}}`
+
+- Run the Puppet agent to fetch and apply configurations from the master:
+
+`puppet agent {{[-t|--test]}}`
+
+- Display help for a specific subcommand:
 
 `puppet help {{subcommand}}`
 
+- Display general help:
+
+`puppet {{[-h|--help]}}`
+
 - Display version:
 
-`puppet --version`
+`puppet {{[-V|--version]}}`