Apply suggestions from code review

Co-authored-by: per1234 <accounts@perglass.com>

Author: cmaglie

arduino/sketch/profiles.go

@@ -35,7 +35,7 @@ type Project struct {
 	DefaultProfile string   `yaml:"default_profile"`
 }
 
-// AsYaml outputs the project file as Yaml
+// AsYaml outputs the sketch project file as YAML
 func (p *Project) AsYaml() string {
 	res := "profiles:\n"
 	for _, profile := range p.Profiles {

arduino/sketch/sketch.go

@@ -101,7 +101,7 @@ func New(path *paths.Path) (*Sketch, error) {
 	if projectFile.Exist() {
 		prj, err := LoadProjectFile(projectFile)
 		if err != nil {
-			return nil, fmt.Errorf("%s %w", tr("error loading project file:"), err)
+			return nil, fmt.Errorf("%s %w", tr("error loading sketch project file:"), err)
 		}
 		sketch.Project = prj
 	}

docs/sketch-project-file.md

@@ -99,8 +99,8 @@ profiles:
 
 ### Building a sketch
 
-When a `sketch.yaml` file exists in the sketch, it can be leveraged to compile the sketch with the `--profile/-m` flag
-in the `compile` command:
+When a sketch project file is present, it can be leveraged to compile the sketch with the `--profile/-m` flag in the
+`compile` command:
 
 ```
 arduino-cli compile --profile nanorp

docs/sketch-specification.md

@@ -66,6 +66,8 @@ the `data` folder, so any non-code files outside the `data` folder are stripped.
 
 ### Metadata
 
+#### `sketch.json`
+
 Arduino CLI and Arduino Web Editor use a file named sketch.json, located in the sketch root folder, to store sketch
 metadata.
 
@@ -79,13 +81,14 @@ The `included_libs` key defines the library versions the Arduino Web Editor uses
 Arduino Web Editor specific because all versions of all the Library Manager libraries are pre-installed in Arduino Web
 Editor, while only one version of each library may be installed when using the other Arduino development software.
 
-### Sketch project file
+#### Sketch project file
 
 This is an optional file named `sketch.yaml`, located in the root folder of the sketch.
 
-Inside `sketch.yaml` the user can define one or more "profiles": each profile is a description of all the resources
-needed to build the sketch (platform and libraries each pinned to a specific version). For more information see the
-[sketch project file](sketch-project-file.md) documentation.
+Inside the sketch project file the user can define one or more "profiles": each profile is a description of all the
+resources needed to build the sketch (platform and libraries each pinned to a specific version).
+
+For more information see the [sketch project file](sketch-project-file.md) documentation.
 
 ### Secrets