Commit Graph

483 Commits

Author SHA1 Message Date
Andre Wanlin 3e4d49db23 Merge pull request #34060 from raphaeltorquat0/fix/issue-32925
docs(techdocs): fix incorrect S3 permission in AWS configuration
2026-05-08 14:07:57 -05:00
Eva Gustavsson 41b65b190e fix: Correct faulty link to techdocs-cli (#34091)
The link to Github repository of techdocs-cli was
faulty. This commit corrects the link in the
documentation.

Signed-off-by: evhnn29 <eva.gustavsson@t-online.de>
2026-05-08 10:22:56 -04:00
Andre Wanlin 2f33a9f63f Fixes for non-breaking typos and typos configuration
Signed-off-by: Andre Wanlin <awanlin@spotify.com>

More

Signed-off-by: Andre Wanlin <awanlin@spotify.com>
2026-04-29 16:54:05 -05:00
Andre Wanlin 84913005fd Merge pull request #31838 from karthikjeeyar/mkdocs-patch
feat(techdocs): add app-config option to disable external font download
2026-04-29 12:47:12 -05:00
Karthik 610b42f72f update documentation and improve types
Signed-off-by: Karthik <karthik.jk11@gmail.com>
2026-04-29 00:19:03 +05:30
Raphael Torquato 096be8b8ea docs(techdocs): fix incorrect S3 permission in AWS configuration
Changed s3:PutBucketAcl to s3:PutObjectAcl in the migration permissions
section, as PutObjectAcl is the correct permission for copying objects.

Fixes #32925

Signed-off-by: Raphael Torquato <raphael.martini@live.com>
2026-04-25 21:13:09 -03:00
Maximilian Wörner d0f6d9e5c0 Update GitLab URL format in documentation
Signed-off-by: Maximilian Wörner <maxwoerner@gmail.com>
2026-04-17 10:34:28 +02:00
Maximilian Wörner 1933c4b817 Update GitLab URL format in old documentation
Signed-off-by: Maximilian Wörner <maxwoerner@gmail.com>
2026-04-17 10:34:02 +02:00
Andre Wanlin 6c6fbe207a Update docs/features/techdocs/troubleshooting.md
Signed-off-by: Andre Wanlin <67169551+awanlin@users.noreply.github.com>
2026-04-08 11:56:08 -05:00
meleu 7da6368a72 Fix TechDocs CLI link
Updated TechDocs CLI link to point to the correct repository, as the old one is now archived.

Signed-off-by: meleu <meleu@users.noreply.github.com>
2026-04-08 13:04:04 -03:00
Patrik Oldsberg 8632502abe Merge pull request #33436 from jonkoops/remove-legacy-proxy-docs
docs: remove legacy corporate proxy documentation
2026-04-07 16:30:05 +02:00
Patrik Oldsberg 9718e62c2d Merge pull request #33667 from backstage/docs-features-new-frontend-migration
docs: migrate feature documentation to new frontend system as primary content
2026-04-07 12:01:07 +02:00
Patrik Oldsberg b592810c5f Fix duplicate frontmatter IDs in old-system doc pages
Prefix the frontmatter `id` in the --old variants with their
feature area (techdocs-/search-) so Docusaurus no longer reports
duplicate doc ID collisions.

Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
Made-with: Cursor
2026-04-04 23:51:04 +02:00
Patrik Oldsberg 7f6b88783b docs: address review feedback on route refs, typos, and installation steps
Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
Made-with: Cursor
2026-04-04 16:15:01 +02:00
Patrik Oldsberg 18fde07e06 docs: address review feedback on code style in examples
Replace `Promise.resolve(...)` with `async` functions in scaffolder
FormFieldBlueprint.make examples, and switch the TechDocs custom home
page example to use the `plugin.withOverrides` pattern instead of
`createFrontendModule`.

Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
Made-with: Cursor
2026-04-04 12:34:50 +02:00
Fredrik Adelöw bb7768ba06 docs: fix broken links and anchors across documentation
Fix ~30 broken links and anchors across the documentation site, including
incorrect relative paths, mismatched anchor names, zero-width characters
in URLs, and references to renamed or removed headings.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Signed-off-by: Fredrik Adelöw <freben@spotify.com>
2026-03-31 18:43:40 +02:00
Karthik 329f5920b6 feat(techdocs): add techdocs-cli option to disable external font download
Signed-off-by: Karthik <karthik.jk11@gmail.com>
2026-03-31 21:39:52 +05:30
Karthik 5ef8d166cb feat(techdocs): add app-config option to disable external font download
Signed-off-by: Karthik <karthik.jk11@gmail.com>
2026-03-31 21:30:45 +05:30
Patrik Oldsberg 561f555fb1 docs: address copilot review feedback
Fix links in viewing-catalog.md and filter-catalog.md to point to
the new frontend system catalog-customization.md instead of the old
guide. Fix the Kubernetes entity content extension ID to use the
correct `entity-content:kubernetes/kubernetes` format. Wrap raw
extension definitions in `createFrontendModule` in search and
scaffolder docs. Correct TechDocs addon installation instructions
to explicitly install addon modules rather than claiming
auto-discovery.

Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
Made-with: Cursor
2026-03-30 12:42:11 +02:00
Patrik Oldsberg c9132c223c docs: improve new frontend system docs for techdocs, scaffolder, and catalog
Expand the TechDocs home page customization section with concrete examples
showing how to override the page:techdocs extension using a frontend module.

Replace the incorrect scaffolder custom step layouts guide with a note that
this feature is not yet supported in the new frontend system.

Restore missing catalog customization docs for columns, actions, table
options, removing filters, and fully custom catalog pages to ensure parity
with the old frontend system guide.

Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
Made-with: Cursor
2026-03-29 23:04:08 +02:00
Patrik Oldsberg 8ec254cd4b docs: migrate feature docs to new frontend system as primary content
Rewrite documentation for TechDocs, Software Templates, Software Catalog,
Search, and Kubernetes features to use the new frontend system as the
primary installation and configuration instructions. Old frontend system
instructions are moved to separate `--old` suffixed files for pages with
substantial legacy content, or updated inline for pages with minimal
old-system content.

Files migrated:
- techdocs/getting-started.md
- techdocs/how-to-guides.md
- software-templates/writing-custom-step-layouts.md
- software-templates/writing-custom-field-extensions.md
- software-templates/index.md
- software-catalog/catalog-customization.md
- search/getting-started.md
- search/how-to-guides.md
- kubernetes/installation.md

Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
Made-with: Cursor
2026-03-29 21:47:46 +02:00
Jon Koops 980b7f5632 docs: remove legacy corporate proxy documentation
All Node.js versions in Backstage's support matrix (v22 and v24 LTS)
include built-in proxy support via NODE_USE_ENV_PROXY, making the
legacy global-agent/undici workarounds unnecessary. Remove the legacy
proxy guide from contrib/ and all references to the legacy approach
across the docs.

Signed-off-by: Jon Koops <jonkoops@gmail.com>
2026-03-19 17:17:17 +01:00
Andre Wanlin f4c012dee3 Merge pull request #33064 from awanlin/docs/nfs-getting-started-auth
[Docs] NFS - Authentication
2026-03-17 12:35:02 -05:00
Jon Koops 956133bf45 docs: recommend Node.js built-in proxy support for corporate proxies (#33006)
Node.js 22.21.0+ natively supports HTTP_PROXY, HTTPS_PROXY, and
NO_PROXY environment variables via NODE_USE_ENV_PROXY, eliminating the
need for undici and global-agent workarounds. This also works with
node-fetch and cross-fetch since they delegate to node:http/node:https
without overriding the HTTP agent.

Add a new corporate proxy tutorial under docs/ with the recommended
approach and update the legacy guide in contrib/ to point to it.
Update proxy references in the deployment, keeping-backstage-updated,
and TechDocs CLI docs to mention NODE_USE_ENV_PROXY.

Signed-off-by: Jon Koops <jonkoops@gmail.com>
2026-03-17 13:13:00 -04:00
Andre Wanlin 11e380b83a Invert based on feedback
Signed-off-by: Andre Wanlin <awanlin@spotify.com>
2026-03-17 11:15:41 -05:00
Andre Wanlin 9a82ed5269 [Docs] NFS - Authentication
Signed-off-by: Andre Wanlin <awanlin@spotify.com>
2026-03-17 10:30:58 -05:00
Gabriel Dugny 895563a1b7 fix(techdocs): Disable LighBox addon for images wrapped in links
Signed-off-by: Gabriel Dugny <gabriel.dugny@believe.com>

# Conflicts:
#	docs/features/techdocs/addons--new.md
#	docs/features/techdocs/addons.md

# Conflicts:
#	docs/features/techdocs/addons--new.md
2026-03-14 11:27:11 +01:00
chanchalkhatri19 af64800234 docs: fix TechDocs Addons link
Signed-off-by: chanchalkhatri19 <chanchal.khatri01@infosys.com>
2026-03-09 10:45:13 +00:00
Andre Wanlin 5142f60de3 [Doc] Removed Mentions of the New Backend System
Signed-off-by: Andre Wanlin <awanlin@spotify.com>
2026-02-28 11:22:02 -06:00
Gabriel Dugny de62a9d322 chore: update dependency commander to v14, remove old @types/commander
Signed-off-by: Gabriel Dugny <gabriel.dugny@believe.com>
2026-02-16 17:29:25 +01:00
chanchalkhatri19 c0aad22784 docs: fix TechDocs CLI README link path
Signed-off-by: chanchalkhatri19 <chanchal.khatri01@infosys.com>
2026-02-12 11:47:31 +00:00
Andre Wanlin be7c1d73b2 Merge pull request #31526 from aoitoya/techdocs-config-md
TechDocs Configuration documentation update
2026-02-05 16:42:47 -06:00
aramissennyeydd efbf232bfa fix: update more /docs/references links
Signed-off-by: aramissennyeydd <aramis.sennyey@doordash.com>
2026-02-04 10:11:36 -06:00
toya 9473854190 Update techdocs configuration documentation and vocabulary
Signed-off-by: toya <96932308+toyaAoi@users.noreply.github.com>
2026-01-31 07:32:49 +05:30
Saptarshi Mula 3934a9f990 Merge branch 'backstage:master' into techdocs-config-md 2026-01-21 22:06:18 +05:30
Vincenzo Scamporlino b5914dfe6d docs: clarify techdocs s3 buckets integration
Signed-off-by: Vincenzo Scamporlino <vincenzos@spotify.com>
2025-12-04 10:07:22 +01:00
toya e4c1ba6a53 techdocs config doc update
Signed-off-by: toya <96932308+toyaAoi@users.noreply.github.com>
Signed-off-by: Saptarshi Mula <96932308+toyaAoi@users.noreply.github.com>
2025-10-25 23:29:11 +05:30
Fredrik Adelöw 6a42abe379 Merge pull request #31058 from AdityaK60/fix-microsite-warning
Fixed duplicate route warning for TechDocs Addons documentation in Do…
2025-09-22 22:40:52 +02:00
Aditya Kumar a4d3260567 Update addons--new.md
Signed-off-by: Aditya Kumar <136452216+AdityaK60@users.noreply.github.com>
2025-09-15 15:11:43 +05:30
Aditya Kumar 7a40a90c64 Update addons.md
Signed-off-by: Aditya Kumar <136452216+AdityaK60@users.noreply.github.com>
2025-09-15 15:10:38 +05:30
Hayato Kihara d03010ec9b docs: Add missing TOC entries to TechDocs FAQ (#30900)
Signed-off-by: Hayato Kihara <kai.21banana@gmail.com>
2025-09-10 14:23:23 -04:00
Owen Shartle 169ae728b8 Moving the TechDocs entity annotation FAQ entry.
Signed-off-by: Owen Shartle <timeloveinvent+github@gmail.com>
2025-09-06 21:23:00 -04:00
Aditya Kumar 01bf98c778 Fixed duplicate route warning for TechDocs Addons documentation in Docusaurus
Signed-off-by: Aditya Kumar <aditya.kumar60@infosys.com>
2025-09-04 14:40:48 +05:30
Owen Shartle a0b604cb6a Adding handling which checks if the current entity (the catalog entity being loaded) has an annotation for an external entity's TechDocs. If it does then we will redirect there rather than allowing a 404 (mic drop). This helps keep older URLs routing to the updated locations.
Adding changesets.
Adding test coverage for external TechDocs entitiy redirect.

Signed-off-by: Owen Shartle <timeloveinvent+github@gmail.com>
2025-08-25 15:39:29 -04:00
Jonas Mai c118dcda83 docs(techdocs): Azure Storage Account Auth Guide Update (#30304)
* Azure Storage Account Auth Guide Update

Describe how any method supported by `DefaultAzureCredential ` can be used to authenticate.

Signed-off-by: Jonas Mai <hubwoop@users.noreply.github.com>

* Update using-cloud-storage.md

Signed-off-by: Jonas Mai <hubwoop@users.noreply.github.com>

* Replace VMs with Virtual Machines

As recommended by code-review

Co-authored-by: Andre Wanlin <67169551+awanlin@users.noreply.github.com>
Signed-off-by: Jonas Mai <hubwoop@users.noreply.github.com>

---------

Signed-off-by: Jonas Mai <hubwoop@users.noreply.github.com>
Co-authored-by: Andre Wanlin <67169551+awanlin@users.noreply.github.com>
2025-07-28 13:52:47 -04:00
Nick Hudkins cb0541f294 feat(sanitizer): add support for allowlisting additional URI protocols
Signed-off-by: Nick Hudkins <nick@nickhudkins.com>
2025-07-21 13:23:32 -04:00
Andre Wanlin b5545900a4 Initial removal
Signed-off-by: Andre Wanlin <awanlin@spotify.com>
2025-06-06 13:14:54 -05:00
Chris Suich 992da5cbdc update docs to indicate this works standalone
Signed-off-by: Chris Suich <csuich2@gmail.com>
2025-05-05 10:54:20 -04:00
Chris Suich ec7b35d77e feat: add techdocs-entity-path annotation for techdocs deep linking
This annotation enables specifying a path within another entities
techdocs to use as the root techdocs page.

Signed-off-by: Chris Suich <csuich2@gmail.com>
2025-04-28 11:32:28 -04:00
Gabriel Dugny 14bddfd10f docs: Fix typos
Signed-off-by: Gabriel Dugny <gabriel.dugny@believe.com>
2025-04-18 17:32:34 +02:00