Clean up comments

Author: GeorgeLyon

Sources/SKCore/CompilationDatabase.swift

@@ -115,14 +115,14 @@ public struct FixedCompilationDatabase: CompilationDatabase, Equatable {
 
 extension FixedCompilationDatabase {
   /// Loads the compilation database located in `directory`, if any.
-  /// returns: `nil` if `compile_flags.txt` was not found
+  /// - Returns: `nil` if `compile_flags.txt` was not found
   public init?(directory: AbsolutePath, _ fileSystem: FileSystem = localFileSystem) throws {
     let path = directory.appending(component: "compile_flags.txt")
     try self.init(file: path, fileSystem)
   }
 
   /// Loads the compilation database from `file`
-  /// returns: `nil` if the file does not exist
+  /// - Returns: `nil` if the file does not exist
   public init?(file: AbsolutePath, _ fileSystem: FileSystem = localFileSystem) throws {
     self.directory = file.dirname
 
@@ -217,7 +217,7 @@ extension JSONCompilationDatabase {
   }
 
   /// Loads the compilation database from `file`
-  /// returns: `nil` if the file does not exist
+  /// - Returns: `nil` if the file does not exist
   public init?(file: AbsolutePath, _ fileSystem: FileSystem = localFileSystem) throws {
     guard fileSystem.exists(file) else {
       return nil