chore: Revisit the spellings of "FossID"

Whenever the actual product name is meant, the spelling should match
the official one: "FossID".

While at it, also apply some minor other wording improvements in the
vicinity of the changes.

Signed-off-by: Sebastian Schuberth <[email protected]>

Author: sschuberth

clients/fossid-webapp/src/main/kotlin/FossIdRestService.kt

@@ -173,8 +173,8 @@ interface FossIdRestService {
         /**
          * A class to modify the standard Jackson deserialization to deal with inconsistencies in responses
          * sent by the FossID server.
-         * When deleting a scan, FossId returns the scan id as String in the 'data' property of the response. If no scan
-         * could be found, it returns an empty array. Starting with FossID version 2023.1, the return type of the
+         * When deleting a scan, FossID returns the scan id as a string in the `data` property of the response. If no
+         * scan could be found, it returns an empty array. Starting with FossID version 2023.1, the return type of the
          * [deleteScan] function is now a map of strings to strings. Creating a special [FossIdServiceWithVersion]
          * implementation for this call is an overkill as ORT does not even use the return value. Therefore, this change
          * is also handled by the [PolymorphicIntDeserializer].

model/src/main/kotlin/config/ReporterConfiguration.kt

@@ -29,8 +29,8 @@ import org.ossreviewtoolkit.plugins.api.PluginConfig
 @JsonInclude(JsonInclude.Include.NON_NULL)
 data class ReporterConfiguration(
     /**
-     * Reporter specific configuration options. The key needs to match the name of the reporter class, e.g. "FossId"
-     * for the FossId reporter. See the documentation of the reporter for available options.
+     * Reporter-specific configuration options. The key needs to match the ID of the reporter plugin, e.g. "FossId" for
+     * the "FossIdReporter" class. See the documentation of the reporter for available options.
      */
     val config: Map<String, PluginConfig>? = null
 )

plugins/scanners/fossid/src/main/kotlin/FossId.kt

@@ -264,7 +264,7 @@ class FossId internal constructor(
     override fun scanPackage(nestedProvenance: NestedProvenance?, context: ScanContext): ScanResult {
         val startTime = Instant.now()
 
-        // FossId actually never uses the provenance determined by the scanner, but determines the source code to
+        // FossID actually never uses the provenance determined by the scanner, but determines the source code to
         // download itself based on the passed VCS URL and revision, disregarding any VCS path.
         val pkg = context.coveredPackages.first()
         val provenance = pkg.vcsProcessed.revision.takeUnless { it.isBlank() }

plugins/scanners/fossid/src/main/kotlin/FossIdUrlProvider.kt

@@ -32,7 +32,7 @@ import org.ossreviewtoolkit.utils.ort.requestPasswordAuthentication
 /**
  * An internal helper class that generates the URLs used by [FossId] to check out the repositories to be scanned.
  *
- * The URLs used by FossId can sometimes be different from the normal package URLs. For instance, credentials may need
+ * The URLs used by [FossId] can sometimes be different from the normal package URLs. For instance, credentials may need
  * to be added, or a different protocol may be used. This class takes care of such mappings.
  */
 class FossIdUrlProvider private constructor(

plugins/scanners/fossid/src/test/kotlin/FossIdLicenseMappingTest.kt

@@ -56,7 +56,7 @@ class FossIdLicenseMappingTest : WordSpec({
             findings.licenseFindings should beEmpty()
         }
 
-        "map non-SPDX compliant FossId licenses in a snippet to snippet findings" {
+        "map non-SPDX compliant FossID licenses in a snippet to snippet findings" {
             val rawResults = createSnippet("Apache 2.0")
             val issues = mutableListOf<Issue>()
 
@@ -79,7 +79,7 @@ class FossIdLicenseMappingTest : WordSpec({
             }
         }
 
-        "map deprecated SPDX FossId licenses in a snippet to snippet findings" {
+        "map deprecated SPDX FossID licenses in a snippet to snippet findings" {
             val rawResults = createSnippet("GFDL-1.2")
             val issues = mutableListOf<Issue>()
 
@@ -101,7 +101,7 @@ class FossIdLicenseMappingTest : WordSpec({
             }
         }
 
-        "map SPDX compliant FossId licenses in a snippet to snippet findings" {
+        "map SPDX compliant FossID licenses in a snippet to snippet findings" {
             val rawResults = createSnippet("Apache-2.0")
             val issues = mutableListOf<Issue>()