Add article: Authenticate to third-party services#420
Draft
vicroms wants to merge 7 commits intoMicrosoftDocs:mainfrom
Draft
Add article: Authenticate to third-party services#420vicroms wants to merge 7 commits intoMicrosoftDocs:mainfrom
vicroms wants to merge 7 commits intoMicrosoftDocs:mainfrom
Conversation
Contributor
|
Learn Build status updates of commit 7f3048b:
|
| File | Status | Preview URL | Details |
|---|---|---|---|
| vcpkg/consume/third-party-authentication.md | View | Details | |
| vcpkg/TOC.yml | ✅Succeeded | View | |
| vcpkg/users/authentication.md | ✅Succeeded | View |
vcpkg/consume/third-party-authentication.md
- Line 42, Column 69: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#azurl' in 'users/assetcaching.md', did you mean '#x-azurl'? - Line 56, Column 1: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#AUTHORIZATION_TOKEN' in 'maintainers/functions/vcpkg_from_github.md'. - Line 58, Column 1: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#AUTHORIZATION_TOKEN' in 'maintainers/functions/vcpkg_from_gitlab.md'. - Line 66, Column 67: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#github-actions-cache' in 'reference/binarycaching.md'. - Line 73, Column 18: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#github-packages' in 'reference/binarycaching.md'.
For more details, please refer to the build report.
Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.
For any questions, please:
- Try searching the learn.microsoft.com contributor guides
- Post your question in the Learn support channel
Thomas1664
reviewed
Nov 2, 2024
Contributor
Thomas1664
left a comment
Thomas1664
left a comment
There was a problem hiding this comment.
I do not like the new article because it just acts like a „table of contents“. Users have to jump around in the documentation to find what they are looking for. Obviously, this assumes users know what they’re looking for. IMO rather than linking all over the place from this article, all the other articles should link to the new article which should provide the actual information.
Please also notice the warnings on wrong links.
This comment was marked as outdated.
This comment was marked as outdated.
This comment was marked as outdated.
This comment was marked as outdated.
|
|
||
| Asset caching can help with these common development scenarios: | ||
| Asset caching allows you to configure alternative download locations (caches) to acquire assets. When enabled, vcpkg first | ||
| attempst to acquire assets from any configured cache location, and falls back to the original download if no cached asset |
Comment on lines
+22
to
+24
| * Reducing dependency from external networks. Possibly, also reducing download times. | ||
| * Mirroring assets in trusted locations for air-gapped environments. | ||
| * Maintaining continuity of business if assets hosted by third-parties are changed or unavailable. |
Collaborator
There was a problem hiding this comment.
Suggested change
| * Reducing dependency from external networks. Possibly, also reducing download times. | |
| * Mirroring assets in trusted locations for air-gapped environments. | |
| * Maintaining continuity of business if assets hosted by third-parties are changed or unavailable. | |
| * Reducing download times and bandwidth costs. | |
| * Mirroring assets in trusted locations for air-gapped or offline environments. | |
| * Maintaining continuity of business if assets hosted by third-parties are changed or unavailable. |
| The expected value is a semicolon-delimited list of asset caching sources. Read the [asset caching reference | ||
| documentation](../users/assetcaching.md) to learn the configuration syntax. | ||
|
|
||
| Example using Azure Blob Storage as an asset cache: |
Collaborator
There was a problem hiding this comment.
Suggested change
| Example using Azure Blob Storage as an asset cache: | |
| ### Example using Azure Blob Storage: |
|
|
||
| * `clear`, disables any previously configured asset cache | ||
| * `x-azurl,file://C:/vcpkg/asset-cache,,readwrite`, sets a filesystem asset cache, located in | ||
| * `x-azurl,file://D:/vcpkg/asset-cache,,readwrite`, sets a filesystem asset cache, located in |
Collaborator
There was a problem hiding this comment.
Suggested change
| * `x-azurl,file://D:/vcpkg/asset-cache,,readwrite`, sets a filesystem asset cache, located in | |
| * `x-azurl,file:///D:/vcpkg/asset-cache,,readwrite`, sets a filesystem asset cache, located in |
|
|
||
| ### 1 - Create a Shared Access Signature Token in the Azure portal | ||
|
|
||
| 1 - Open the [Azure portal](https://portal.azure.com/#home) and navigate to your container. |
Collaborator
There was a problem hiding this comment.
Renders as a paragraph, not as a list.
| zone_pivot_group_filename: zone-pivot-groups.json | ||
| zone_pivot_groups: shell-selections | ||
| --- | ||
| # Authenticate to third-party services |
Collaborator
There was a problem hiding this comment.
Consider breaking this into multiple separate articles, because it seems like this article is serving disjoint audiences.
Contributor
|
Learn Build status updates of commit 02f467d:
|
| File | Status | Preview URL | Details |
|---|---|---|---|
| vcpkg/consume/third-party-authentication.md | View | Details | |
| vcpkg/consume/asset-caching.md | ✅Succeeded | View | |
| vcpkg/resources/ado-copy-pat.png | ✅Succeeded | View | |
| vcpkg/resources/ado-create-pat.png | ✅Succeeded | View | |
| vcpkg/resources/ado-options-pat.png | ✅Succeeded | View | |
| vcpkg/resources/connect-to-nuget-feed.png | ✅Succeeded | View | |
| vcpkg/resources/create-nuget-feed.png | ✅Succeeded | View | |
| vcpkg/TOC.yml | ✅Succeeded | View | |
| vcpkg/users/authentication.md | ✅Succeeded | View |
vcpkg/consume/third-party-authentication.md
- Line 92, Column 45: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#x-azuniversal' in 'reference/binarycaching.md', did you mean '#azuniversal'? - Line 135, Column 5: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#github-actions-cache' in 'reference/binarycaching.md'. - Line 186, Column 10: [Suggestion: learn-site-link-broken - See documentation]
Link '/nuget/consume-packages/consuming-packages-authenticated-feed#security-best-practices-for-managing-credentials' points to a learn site page that doesn't exist. Check the path or URL and update the link.
For more details, please refer to the build report.
Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.
For any questions, please:
- Try searching the learn.microsoft.com contributor guides
- Post your question in the Learn support channel
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
No description provided.