paulononato/backstage
1
0
Fork 0
Code Issues Pull Requests Actions 2 Packages Projects Releases Wiki Activity
Files
c3ea694e8400a35e2dfe4cf577c0fa66c66a8570
backstage/plugins/techdocs/CHANGELOG.md
T
github-actions[bot] c5584b62c2 Version Packages
2021-01-21 13:13:05 +00:00

12 KiB
Raw Blame History

@backstage/plugin-techdocs

0.5.4

Patch Changes

  • a5e27d5c1: Create type for TechDocsMetadata (#3716)

    This change introduces a new type (TechDocsMetadata) in packages/techdocs-common. This type is then introduced in the endpoint response in techdocs-backend and in the api interface in techdocs (frontend).

  • Updated dependencies [def2307f3]

  • Updated dependencies [efd6ef753]

  • Updated dependencies [593632f07]

  • Updated dependencies [33846acfc]

  • Updated dependencies [a187b8ad0]

  • Updated dependencies [f04db53d7]

  • Updated dependencies [53c9c51f2]

  • Updated dependencies [a5e27d5c1]

  • Updated dependencies [a93f42213]

    • @backstage/catalog-model@0.7.0
    • @backstage/core@0.5.0
    • @backstage/plugin-catalog@0.2.12
    • @backstage/techdocs-common@0.3.5

0.5.3

Patch Changes

  • dbe4450c3: Google Cloud authentication in TechDocs has been improved.

    1. techdocs.publisher.googleGcs.credentials is now optional. If it is missing, GOOGLE_APPLICATION_CREDENTIALS environment variable (and some other methods) will be used to authenticate. Read more here https://cloud.google.com/docs/authentication/production

    2. techdocs.publisher.googleGcs.projectId is no longer used. You can remove it from your app-config.yaml.

  • a6f9dca0d: Remove dependency on @backstage/core-api. No plugin should ever depend on that package; it's an internal concern whose important bits are re-exported by @backstage/core which is the public facing dependency to use.

  • b3b9445df: AWS S3 authentication in TechDocs has been improved.

    1. techdocs.publisher.awsS3.bucketName is now the only required config. techdocs.publisher.awsS3.credentials and techdocs.publisher.awsS3.region are optional.

    2. If techdocs.publisher.awsS3.credentials and techdocs.publisher.awsS3.region are missing, the AWS environment variables AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY and AWS_REGION will be used. There are more better ways of setting up AWS authentication. Read the guide at https://backstage.io/docs/features/techdocs/using-cloud-storage

  • e5d12f705: Use history.pushState for hash link navigation.

  • Updated dependencies [68ad5af51]

  • Updated dependencies [f3b064e1c]

  • Updated dependencies [371f67ecd]

  • Updated dependencies [f1e74777a]

  • Updated dependencies [dbe4450c3]

  • Updated dependencies [c00488983]

  • Updated dependencies [265a7ab30]

  • Updated dependencies [5826d0973]

  • Updated dependencies [b3b9445df]

  • Updated dependencies [abbee6fff]

  • Updated dependencies [147fadcb9]

    • @backstage/techdocs-common@0.3.3
    • @backstage/catalog-model@0.6.1
    • @backstage/plugin-catalog@0.2.11
    • @backstage/core@0.4.4

0.5.2

Patch Changes

  • 359f9d2d8: Added configuration schema for the commonly used properties of techdocs and techdocs-backend plugins
  • Updated dependencies [a08c32ced]
  • Updated dependencies [7e0b8cac5]
  • Updated dependencies [8804e8981]
  • Updated dependencies [87c0c53c2]
  • Updated dependencies [86c3c652a]
  • Updated dependencies [27f2af935]
    • @backstage/core-api@0.2.8
    • @backstage/core@0.4.3
    • @backstage/plugin-catalog@0.2.9
    • @backstage/techdocs-common@0.3.1

0.5.1

Patch Changes

  • Updated dependencies [d681db2b5]
  • Updated dependencies [1dc445e89]
  • Updated dependencies [342270e4d]
  • Updated dependencies [1dc445e89]
  • Updated dependencies [a8573e53b]
    • @backstage/core-api@0.2.7
    • @backstage/core@0.4.2
    • @backstage/test-utils@0.1.6
    • @backstage/plugin-catalog@0.2.8
    • @backstage/techdocs-common@0.3.0

0.5.0

Minor Changes

  • dae4f3983: Breaking changes

    1. Added option to use Google Cloud Storage as a choice to store the static generated files for TechDocs. It can be configured using techdocs.publisher.type option in app-config.yaml. Step-by-step guide to configure GCS is available here https://backstage.io/docs/features/techdocs/using-cloud-storage Set techdocs.publisher.type to 'local' if you want to continue using local filesystem to store TechDocs files.

    2. techdocs.builder is now required and can be set to 'local' or 'external'. (Set it to 'local' for now, since CI/CD build workflow for TechDocs will be available soon (in few weeks)). If builder is set to 'local' and you open a TechDocs page, techdocs-backend will try to generate the docs, publish to storage and show the generated docs afterwords. If builder is set to 'external', techdocs-backend will only fetch the docs and will NOT try to generate and publish. In this case of 'external', we assume that docs are being built in the CI/CD pipeline of the repository. TechDocs will not assume a default value for techdocs.builder. It is better to explicitly define it in the app-config.yaml.

    3. When configuring TechDocs in your backend, there is a difference in how a new publisher is created.

    ---  const publisher = new LocalPublish(logger, discovery);
+++  const publisher = Publisher.fromConfig(config, logger, discovery);

    Based on the config techdocs.publisher.type, the publisher could be either Local publisher or Google Cloud Storage publisher.

    1. techdocs.storageUrl is now a required config. Should be http://localhost:7000/api/techdocs/static/docs in most setups.

    2. Parts of @backstage/plugin-techdocs-backend have been moved to a new package @backstage/techdocs-common to generate docs. Also to publish docs to-and-fro between TechDocs and a storage (either local or external). However, a Backstage app does NOT need to import the techdocs-common package - app should only import @backstage/plugin-techdocs and @backstage/plugin-techdocs-backend.

    Patch changes

    1. See all of TechDocs config options and its documentation https://backstage.io/docs/features/techdocs/configuration

    2. Logic about serving static files and metadata retrieval have been abstracted away from the router in techdocs-backend to the instance of publisher.

    3. Removed Material UI Spinner from TechDocs header. Spinners cause unnecessary UX distraction. Case 1 (when docs are built and are to be served): Spinners appear for a split second before the name of site shows up. This unnecessarily distracts eyes because spinners increase the size of the Header. A dot (.) would do fine. Definitely more can be done. Case 2 (when docs are being generated): There is already a linear progress bar (which is recommended in Storybook).

Patch Changes

  • Updated dependencies [c911061b7]
  • Updated dependencies [dae4f3983]
  • Updated dependencies [8ef71ed32]
  • Updated dependencies [0e6298f7e]
  • Updated dependencies [7dd2ef7d1]
  • Updated dependencies [ac3560b42]
    • @backstage/catalog-model@0.6.0
    • @backstage/techdocs-common@0.2.0
    • @backstage/core@0.4.1
    • @backstage/core-api@0.2.6
    • @backstage/plugin-catalog@0.2.7

0.4.0

Minor Changes

  • 87a33d2fe: Removed modifyCss transformer and moved the css to injectCss transformer Fixed issue where some internal doc links would cause a reload of the page

Patch Changes

  • Updated dependencies [b6557c098]
  • Updated dependencies [2527628e1]
  • Updated dependencies [6011b7d3e]
  • Updated dependencies [e1f4e24ef]
  • Updated dependencies [1c69d4716]
  • Updated dependencies [d8d5a17da]
  • Updated dependencies [83b6e0c1f]
  • Updated dependencies [1665ae8bb]
  • Updated dependencies [04f26f88d]
  • Updated dependencies [ff243ce96]
    • @backstage/core-api@0.2.5
    • @backstage/core@0.4.0
    • @backstage/plugin-catalog@0.2.6
    • @backstage/test-utils@0.1.5
    • @backstage/catalog-model@0.5.0
    • @backstage/theme@0.2.2

0.3.1

Patch Changes

  • da2ad65cb: Use type EntityName from catalog-model for entities
  • Updated dependencies [b4488ddb0]
  • Updated dependencies [08835a61d]
  • Updated dependencies [a9fd599f7]
  • Updated dependencies [bcc211a08]
  • Updated dependencies [ebf37bbae]
    • @backstage/core-api@0.2.4
    • @backstage/catalog-model@0.4.0
    • @backstage/plugin-catalog@0.2.5
    • @backstage/test-utils@0.1.4

0.3.0

Minor Changes

  • 4b53294a6: - Use techdocs annotation to add repo_url if missing in mkdocs.yml. Having repo_url creates a Edit button on techdocs pages.
    • techdocs-backend: API endpoint /metadata/mkdocs/* renamed to /metadata/techdocs/*

Patch Changes

  • Updated dependencies [6f70ed7a9]
  • Updated dependencies [ab94c9542]
  • Updated dependencies [2daf18e80]
  • Updated dependencies [069cda35f]
  • Updated dependencies [700a212b4]
    • @backstage/plugin-catalog@0.2.4
    • @backstage/catalog-model@0.3.1
    • @backstage/core-api@0.2.3

0.2.3

Patch Changes

  • Updated dependencies [475fc0aaa]
  • Updated dependencies [1166fcc36]
  • Updated dependencies [1185919f3]
    • @backstage/core@0.3.2
    • @backstage/catalog-model@0.3.0
    • @backstage/plugin-catalog@0.2.3

0.2.2

Patch Changes

  • 1722cb53c: Added configuration schema
  • Updated dependencies [1722cb53c]
  • Updated dependencies [8b7737d0b]
    • @backstage/core@0.3.1
    • @backstage/plugin-catalog@0.2.2
    • @backstage/test-utils@0.1.3

0.2.1

Patch Changes

0.2.0

Minor Changes

  • 28edd7d29: Create backend plugin through CLI

  • 8351ad79b: Add a message if techdocs takes long time to load

    Fixes #2416.

    The UI after the change should look like this:

    techdocs-progress-bar

Patch Changes

Reference in New Issue View Git Blame Copy Permalink