Backstage
    Preparing search index...

    Base class for a TechDocs publisher (e.g. Local, Google GCS Bucket, AWS S3, etc.) The publisher handles publishing of the generated static files after the prepare and generate steps of TechDocs. It also provides APIs to communicate with the storage service.

    interface PublisherBase {
        docsRouter(): Handler;
        fetchTechDocsMetadata(
            entityName: CompoundEntityRef,
        ): Promise<TechDocsMetadata>;
        getReadiness(): Promise<ReadinessResponse>;
        hasDocsBeenGenerated(entityName: Entity): Promise<boolean>;
        migrateDocsCase?(migrateRequest: MigrateRequest): Promise<void>;
        publish(request: PublishRequest): Promise<PublishResponse>;
    }
    Index

    Methods

    • Check if the publisher is ready. This check tries to perform certain checks to see if the publisher is configured correctly and can be used to publish or read documentations. The different implementations might e.g. use the provided service credentials to access the target or check if a folder/bucket is available.

      Returns Promise<ReadinessResponse>

    • Migrates documentation objects with case sensitive entity triplets to lowercase entity triplets. This was (will be) a change introduced in techdocs-cli version {0.x.y} and techdocs-backend version {0.x.y}.

      Implementation of this method is unnecessary in publishers introduced after version {0.x.y} of techdocs-node.

      Parameters

      Returns Promise<void>