Update comments

Co-authored-by: Ryan Bottriell <[email protected]>

Signed-off-by: David Gilligan-Cook <[email protected]>

Author: dcookspi

crates/spk-cli/group2/src/cmd_new.rs

@@ -44,11 +44,11 @@ fn get_stub(name: &PkgNameBuf) -> String {
 
 build:
 
-  # Set what level of host os compatibility the built package should have:
-  # - full: package can be used on any OS
-  # - os: package can be used anywhere that has the same OS type
-  # - arch: package can be used anywhere that has the same OS and CPU type
-  # - distro: package can only be used on the same OS, CPU, and OS distribution version
+  # Set what level of host compatibility the built package should have:
+  # - full: package can be used on any OS and any architecture
+  # - os: package can be used anywhere that has the same OS type (mac, linux, windows)
+  # - arch: package can be used anywhere that has the same OS and CPU architecture (x86_64, i386)
+  # - distro: package can only be used on the same OS, CPU, and OS distribution version (eg linux distro)
   host_compat: distro
 
   # options are all the inputs to the package build process, including

crates/spk-schema/src/build_spec.rs

@@ -28,7 +28,7 @@ const ARCH_ADDS: &[&OptName] = &[OptName::os(), OptName::arch()];
 const OS_ADDS: &[&OptName] = &[OptName::os()];
 const ANY_ADDS: &[&OptName] = &[];
 
-/// Set what level of cross-platform compatibility the built package
+/// Describes what level of cross-platform compatibility the built package
 /// should have.
 #[derive(
     Clone, Debug, Eq, Hash, Ord, PartialEq, PartialOrd, Deserialize, Serialize, Display, Default,

docs/ref/spec.md

@@ -120,7 +120,7 @@ The ValidationSpec modifies the default validation process for packages, primari
 
 ### HostCompat
 
-The HostCompat value sets the host os related options that are
+The HostCompat value sets the host- and os-related options that are
 automatically added to each build. It also describes the package's
 compatibility with host OSes.