Title: Link error messages to current version of Angular docs · Issue #44650 · angular/angular · GitHub
Open Graph Title: Link error messages to current version of Angular docs · Issue #44650 · angular/angular
X Title: Link error messages to current version of Angular docs · Issue #44650 · angular/angular
Description: Which @angular/* package(s) are relevant/releated to the feature request? compiler-cli Description Error messages frequently link to angular.io for additional context. This is great for users, however the content on these pages change ov...
Open Graph Description: Which @angular/* package(s) are relevant/releated to the feature request? compiler-cli Description Error messages frequently link to angular.io for additional context. This is great for users, howe...
X Description: Which @angular/* package(s) are relevant/releated to the feature request? compiler-cli Description Error messages frequently link to angular.io for additional context. This is great for users, howe...
Opengraph URL: https://github.com/angular/angular/issues/44650
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Link error messages to current version of Angular docs","articleBody":"### Which @angular/* package(s) are relevant/releated to the feature request?\n\ncompiler-cli\n\n### Description\n\nError messages frequently link to angular.io for additional context. This is great for users, however the content on these pages change over time, so error message links could easily fall out of date and stop working (or continue to work but no longer give the context needed by the error).\r\n\r\nI'm marking this as a compiler issue, though the same issue applies to the runtime and we should do the same there.\r\n\r\n/cc @JoostK\n\n### Proposed solution\n\nWe already have archived versions of docs at v*.angular.io, we should link to those versions where appropriate. Ideally, an error message should always link to the same version of Angular they are currently using. So even a user on an LTS (or older) version will link to the correct version of the doc intended by the error message.\r\n\r\nThis does mean that users might not get the most up to date information, but archived docs already include a banner and link to the latest version, so I think historical accuracy is more important and maintainable than recency of information.\n\n### Alternatives considered\n\nThe current solution is to always link to the latest version of the docs (see https://github.com/angular/angular/pull/44649#pullrequestreview-845998595). If docs change, we just update the error message to match (or vice versa). This technically means that we shouldn't remove docs content from the latest AIO version until the Angular versions it's relevant to fall out of LTS (which is a two-year gap I think). It's also easy to forget that an old version linked to particular doc and hard to audit / verify. We also can't change older versions of Angular after their published, so our only remediation mechanism is to update AIO directly.","author":{"url":"https://github.com/dgp1130","@type":"Person","name":"dgp1130"},"datePublished":"2022-01-06T19:56:44Z","url":"https://github.com/angular/angular/issues/44650"}
| react-profiling | 0 |
| react-import-map | react,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322 |
| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:73066134-af11-fcd2-6d28-7cf29a00661f |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | C970:19E4BB:1547964:1B2549B:6B013142 |
| html-safe-nonce | d70c41c93f30968f990e8be07b57958a983f232996fab5a285f0efcc28ca62ba |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJDOTcwOjE5RTRCQjoxNTQ3OTY0OjFCMjU0OUI6NkIwMTMxNDIiLCJ2aXNpdG9yX2lkIjoiMzE2OTI3MDM0OTYzMjE4ODczOSIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9 |
| visitor-hmac | d66e67fb9a7051f1cef8327470438fe8e4f05563c59b5e362f626b3206b4d33e |
| hovercard-subject-tag | issue:1095646600 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/angular/angular/44650/issue_layout |
| twitter:image | https://opengraph.githubassets.com/ca9c2bb529bd26992f417dddc69f576ee41c858566576d2465e64274d4764b8e/angular/angular/issues/44650 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/ca9c2bb529bd26992f417dddc69f576ee41c858566576d2465e64274d4764b8e/angular/angular/issues/44650 |
| og:image:alt | Which @angular/* package(s) are relevant/releated to the feature request? compiler-cli Description Error messages frequently link to angular.io for additional context. This is great for users, howe... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | dgp1130 |
| hostname | github.com |
| expected-hostname | github.com |
| None | cc5dfdd32f62ebd3223cab3af3aa2b268d3605218237326a48a99d1efd89495c |
| turbo-cache-control | no-preview |
| go-import | github.com/angular/angular git https://github.com/angular/angular.git |
| octolytics-dimension-user_id | 139426 |
| octolytics-dimension-user_login | angular |
| octolytics-dimension-repository_id | 24195339 |
| octolytics-dimension-repository_nwo | angular/angular |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 24195339 |
| octolytics-dimension-repository_network_root_nwo | angular/angular |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | 8c77c9e8439031ad54c75a250694842892f693e1 |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
| react-app-name | issues |
Links:
Viewport: width=device-width