fix: improve API reference URLs take 2 (#726)

See #720 for original context.

Compared to the original PR, this adds the following fixes:
- reduces the size of the output of the transliterator handler by taking the created/deleted `S3Object` arrays and only returning the keys instead. This is needed to prevent failures caused by the output being too large.
- fixes logic for the linkFormatter and updates it to give incorrect error messages

TODO: update jsii-docgen version once cdklabs/jsii-docgen#571 is merged

----

*By submitting this pull request, I confirm that my contribution is made under the terms of the Apache-2.0 license*

.projenrc.js

@@ -400,7 +400,7 @@ function newLambdaHandler(entrypoint, trigger) {
   const propsName = `${className}Props`;
 
   const ts = new SourceCode(project, infra);
-  ts.line(`// ${FileBase.PROJEN_MARKER}`);
+  ts.line(`// ${ts.marker}`);
   ts.line('import * as path from \'path\';');
   ts.line('import * as lambda from \'@aws-cdk/aws-lambda\';');
   ts.line('import { Construct } from \'@aws-cdk/core\';');
@@ -500,7 +500,7 @@ function newEcsTask(entrypoint) {
   const propsName = `${className}Props`;
 
   const ts = new SourceCode(project, infra);
-  ts.line(`// ${FileBase.PROJEN_MARKER}`);
+  ts.line(`// ${ts.marker}`);
   ts.line('import * as path from \'path\';');
   ts.line('import * as ecs from \'@aws-cdk/aws-ecs\';');
   ts.line('import * as iam from \'@aws-cdk/aws-iam\';');
@@ -534,7 +534,7 @@ function newEcsTask(entrypoint) {
   // appropriate down-leveling (e.g: for use of the `??` operator).
   const main = new SourceCode(project, ecsMain);
   main.line('#!/usr/bin/env node');
-  main.line(`// ${FileBase.PROJEN_MARKER}`);
+  main.line(`// ${main.marker}`);
   main.line();
   main.line('import * as os from \'os\';');
   main.line('import { argv, env, exit } from \'process\';');
@@ -599,7 +599,7 @@ function newEcsTask(entrypoint) {
   main.close('});');
 
   const df = new SourceCode(project, dockerfile);
-  df.line(`# ${FileBase.PROJEN_MARKER}`);
+  df.line(`# ${df.marker}`);
   // Based off amazonlinux:2 for... reasons. (Do not change!)
   df.line('FROM public.ecr.aws/amazonlinux/amazonlinux:2');
   df.line();
@@ -639,7 +639,7 @@ function newEcsTask(entrypoint) {
     description: `Continuously update an AWS Fargate bundle from ${entry}`,
     exec: [...bundleCmd, '--watch'].join(' '),
   });
-  bundle.env(BUNDLE_DIR_ENV, outdir);
+  bundleWatch.env(BUNDLE_DIR_ENV, outdir);
 
   project.compileTask.spawn(bundle);
   bundleTask.spawn(bundle);
@@ -722,7 +722,7 @@ function discoverEcsTasks() {
 function generateSpdxLicenseEnum() {
   const ts = new SourceCode(project, 'src/spdx-license.ts');
 
-  ts.line(`// ${FileBase.PROJEN_MARKER}`);
+  ts.line(`// ${ts.marker}`);
   // We *need* the private field to be declared before any public field is...
   ts.line('/* eslint-disable @typescript-eslint/member-ordering */');
   ts.line();