message: Tweak changeset example comments
diff: '@backstage/plugin-techdocs-backend': patch
  ---
  -Output logs from a TechDocs build to a logging transport in addition to existing frontend event stream, for capturing these logs to other sources.
  +Output logs from a TechDocs build to a logging transport in addition to existing
  +frontend event stream, for capturing these logs to other sources.
  -This allows users to capture debugging information around why tech docs fail to build without needing to rely on end users capturing information from their web browser.
  +This allows users to capture debugging information around why tech docs fail to build
  +without needing to rely on end users capturing information from their web browser.
  -The most common use case is to log to the same place as the rest of the backend application logs.
  +The most common use case is to log to the same place as the rest of the backend
  +application logs.
  Sample usage:
  @@ -25,31 +28,24 @@ import { PluginEnvironment } from '../types';
  export default async function createPlugin(
  env: PluginEnvironment,
  ): Promise<Router> {
  - // Preparers are responsible for fetching source files for documentation.
  const preparers = await Preparers.fromConfig(env.config, {
  logger: env.logger,
  reader: env.reader,
  });
  - // Docker client (conditionally) used by the generators, based on techdocs.generators config.
  const dockerClient = new Docker();
  const containerRunner = new DockerContainerRunner({ dockerClient });
  - // Generators are used for generating documentation sites.
  const generators = await Generators.fromConfig(env.config, {
  logger: env.logger,
  containerRunner,
  });
  - // Publisher is used for
  - // 1. Publishing generated files to storage
  - // 2. Fetching files from storage and passing them to TechDocs frontend.
  const publisher = await Publisher.fromConfig(env.config, {
  logger: env.logger,
  discovery: env.discovery,
  });
  - // checks if the publisher is working and logs the result
  await publisher.getReadiness();
  return await createRouter({
  @@ -57,6 +53,8 @@ export default async function createPlugin(
  generators,
  publisher,
  logger: env.logger,
  + // Passing a buildLogTransport as a parameter in createRouter will enable
  + // capturing build logs to a backend log stream
  buildLogTransport: env.logger,
  config: env.config,
  discovery: env.discovery,
  