Граф коммитов

103 Коммитов

Автор SHA1 Сообщение Дата
Daniel Jurek c2a8656e0f
Workaround to enable OpenAI documentation on learn.microsoft.com (#31788)
Work item to undo the workaround when proper support is implemented in
`type2docfx`: https://github.com/Azure/azure-sdk-for-js/issues/31787

Docs with changes in place:
https://review.learn.microsoft.com/en-us/javascript/api/overview/azure/openai-readme?view=azure-node-preview&branch=djurek%2Fopenai-readme

The change in `Docs-Toc.ps1` adds the OpenAI entry and then sorts the
packages in Cognitive Services so that OpenAI ends up in the right
place.
2024-11-15 13:43:32 -08:00
Albert Cheng 725dc4ca77
ESRP safety net (#31292)
closes #30267

---------

Co-authored-by: Ben Broderick Phillips <ben@benbp.net>
2024-11-11 17:15:13 +00:00
Scott Beddall 4a2df5ac62
`js - pullrequest` (#31420)
This pullrequest adds a definition for an expanding and contracting
build that will be used to replace all `js - <service> - ci` build
definitions in the `public` devops project. This is an overall package
selection change, where we find the targeted packages using
`Save-Package-Properties.ps1` primarily. Analyze checks have also been
updated to honor this new selection methodology, rather than the hardcoded
artifactslist.

Only `js - pullrequest` will actually honor the expand and contract for
the packages that were changed in the PR. Meanwhile the `internal`
versions of the `service`-specific definitions will still exist, still
select packages for the service directory, and still be used to release
as normal.

`js - pullrequest` will run _alongside_ the existing builds for a short
period while we identify any outstanding bugs or collection adjustments.
After we're happy, we'll disable all public js builds in favor of the
single `js - pullrequest` build.

---------

Co-authored-by: Ben Broderick Phillips <bebroder@microsoft.com>
2024-11-01 10:59:17 -07:00
Praven Kuttappan 1b240a906f
Update JS parser version to 2.0.3 (#31539)
Update JS APIView parser to 2.0.3
2024-10-26 11:21:14 -04:00
Praven Kuttappan 3d0c106120
Update API view parser to 2.0.2 (#31421)
Update API parser version to 2.0.0 to rebuild reviews with include a bug
fix about context end
2024-10-15 21:01:05 -04:00
Praven Kuttappan ebecebf70c
Update JS parser version (#31407)
Update JS API parser to 2.0.1
2024-10-15 16:51:04 -04:00
Azure SDK Bot acdcea72ef
Sync eng/common directory with azure-sdk-tools for PR 9102 (#31362)
* Add CompatibleConvertFrom-Yaml to common Package-Helpers
* Add CI artifact parsing to Save-Package-Properties, now each individual packageinfo.json file contains the relevant ci artifact lines for the package. This short circuits needing to re-parse this information in common checks.

---------

Co-authored-by: Scott Beddall <scbedd@microsoft.com>
2024-10-11 13:01:49 -07:00
Praven Kuttappan 5799d31aec
Pin API view parser version (#31282)
Pin API view parser version
2024-10-01 13:39:44 -04:00
Daniel Jurek 14484424bc
Docs cleanup (#31215)
Last part of https://github.com/Azure/azure-sdk-tools/issues/6800 that
still needs to be done in JS

Move validation functions from Language-Settings.ps1 to
Docs-Onboarding.ps1


Release process succeeds
https://dev.azure.com/azure-sdk/internal/_build/results?buildId=4171903&view=logs&j=19b87903-f8bc-5cbb-22d9-4f6eb3469d8e&t=39d7f548-7a77-5d57-b2f3-bf0cc5f8dda2
... There is a failure in one of the other template package releases but
it's unrelated to this change.
2024-09-26 17:13:04 +00:00
Daniel Jurek 85298ef944
Clean up deprecated docs functions (#29499) 2024-04-30 17:39:39 +00:00
Praven Kuttappan 1ae5bae4f4
Mark JS pacakge as shipped in APIView after publishing the package (#29236)
Send a request to APIView to mark the package version as shipped in
APIView after it's shipped from a release pipeline.
2024-04-16 21:27:15 -04:00
Azure SDK Bot ceaf03a8ce
Upgrade JS REX Validation Tool (#29229)
This PR upgrades the JS REX Validation Tool to the latest version.
Testing was done in
https://dev.azure.com/azure-sdk/internal/_build/results?buildId=3677655
2024-04-12 16:20:46 +00:00
Praven Kuttappan a94ec2f60a
Create API review using common template (#29144)
JS pipeline was using a repo specific script and template to create API
review. This PR has changes to use common template to create API review.
2024-04-02 13:39:10 -04:00
James Suplizio 986114c52f
Update Get-javascript-DocsMsDevLanguageSpecificPackageInfo in Language-Settings.ps1 (#29075)
This change is necessary to match change in Update-DocsMsMetadata.ps1
made in [this azure-sdk-tools
PR](https://github.com/Azure/azure-sdk-tools/pull/7951). The
Get-javascript-DocsMsDevLanguageSpecificPackageInfo function is the
implementation of the GetDocsMsDevLanguageSpecificPackageInfoFn. This is
something that should have been called all the time but because
javascript was the only language using this, Update-DocsMsMetadata.ps1
was only calling this if the packageInfo file's DevVersion was set.
Because this needs to be called all the time, if it's defined for a
given language, and javascript only needs process if the DevVersion is
set, move that check to the implemented function.
2024-03-26 13:47:35 -07:00
Daniel Jurek 43acedf51a
Domain-specific changes to fix docindex (#28432)
Needed for https://github.com/Azure/azure-sdk-tools/pull/7629 to work

Example pipeline working:
https://dev.azure.com/azure-sdk/internal/_build/results?buildId=3467799&view=logs&j=5e8cddd4-765d-5046-f31f-2d7d6b215293&t=5e8cddd4-765d-5046-f31f-2d7d6b215293
(note CreateDocIndex works)
2024-02-05 16:29:17 -08:00
Patrick Hallisey b76acc8d8d
Add support for autorest preview pipeline (#28042)
Add required overload in LanguageSettings.ps1 to support code generation
from the [autorest.typescript -
preview](https://dev.azure.com/azure-sdk/internal/_build?definitionId=6415)
pipeline
2023-12-13 13:34:12 -08:00
Daniel Jurek 2611bb6f40
Validate docs using the REX tool (#27935)
Fixes #25684 

* Removes docker container
* Updates relevant scripts and removes old code paths
* Adds job to upgrade the REX tool if tests pass

Example runs: 
* Successful run of daily pipeline:
https://dev.azure.com/azure-sdk/internal/_build/results?buildId=3298420&view=logs&j=f8e040b3-c0ff-5789-0eda-99daaaa3fc1b&t=7702a9c8-4b61-5cd3-c28d-9b1cea81bf7e

* Successful SDK package release:
https://dev.azure.com/azure-sdk/internal/_build/results?buildId=3302248&view=logs&j=19b87903-f8bc-5cbb-22d9-4f6eb3469d8e&t=39d7f548-7a77-5d57-b2f3-bf0cc5f8dda2&l=150

* Successful docindex run: 
* pipeline run:
https://dev.azure.com/azure-sdk/internal/_build/results?buildId=3298899&view=logs&j=dc056dfc-c0cf-5958-c8c4-8da4f91a3739&t=dc056dfc-c0cf-5958-c8c4-8da4f91a3739
* diff showing package upgrades did not change (may show drift as
packages release, focus on `ci-configs/packages-*.json`):
https://github.com/MicrosoftDocs/azure-docs-sdk-node/compare/djurek/rex-tests?expand=1


* Tool upgrade:
* No new version:
https://dev.azure.com/azure-sdk/internal/_build/results?buildId=3298685&view=logs&j=f0b9ce84-b5fb-5cd2-d7e4-8e2b722448a2&t=95e002a9-090a-5230-9ea9-b23402ed153e
* New version test and upgrade:
https://dev.azure.com/azure-sdk/internal/_build/results?buildId=3298739&view=logs&j=f0b9ce84-b5fb-5cd2-d7e4-8e2b722448a2&t=95e002a9-090a-5230-9ea9-b23402ed153e
        * PR: https://github.com/Azure/azure-sdk-for-js/pull/27917
* New version test fails:
https://dev.azure.com/azure-sdk/internal/_build/results?buildId=3298727&view=logs&j=f0b9ce84-b5fb-5cd2-d7e4-8e2b722448a2&t=95e002a9-090a-5230-9ea9-b23402ed153e
2023-11-30 13:40:53 -08:00
Daniel Jurek 70722c5458
JS-specific changes: Move deprecated packages to legacy (#27032) 2023-09-13 14:14:30 -07:00
Daniel Jurek 9faa6c61dd
Docs onboarding v2 (#26682)
Requires eng/common changes in
https://github.com/Azure/azure-sdk-tools/pull/6632.
Note: There's also a cleanup
[PR](https://github.com/Azure/azure-sdk-tools/issues/6800) to cleanup
older language specific items.

Test run of
docindex:https://dev.azure.com/azure-sdk/internal/_build/results?buildId=2970911&view=logs&j=dc056dfc-c0cf-5958-c8c4-8da4f91a3739

Converts a collection of metadata JSON files into an onboarding spec.
2023-08-23 14:56:55 -07:00
Daniel Jurek 5dd56f5770
Add skipPublishDocMs to false error reports in docs heuristics (#26773)
Example pipeline fixed by this change: 

* Identity --
https://dev.azure.com/azure-sdk/internal/_build/results?buildId=2995011&view=results
* Core --
https://dev.azure.com/azure-sdk/internal/_build/results?buildId=2995180&view=logs&j=f8e040b3-c0ff-5789-0eda-99daaaa3fc1b&t=f8e040b3-c0ff-5789-0eda-99daaaa3fc1b

Work item to undo this when we integrate `@microsoft/type2docfx`
https://github.com/Azure/azure-sdk-for-js/issues/26770
2023-08-10 18:51:18 +00:00
Daniel Jurek bd5ad0be51
Enable nightly build pipeline failure on docs.ms validation failure (#26548)
Builds: 

*
https://dev.azure.com/azure-sdk/internal/_build/results?buildId=2931582&view=results
*
https://dev.azure.com/azure-sdk/internal/_build/results?buildId=2931583&view=results
2023-07-27 13:49:18 -07:00
Daniel Jurek c5e3cb535c
Fix: Handle empty DirectoryFolder metadata property (#26125)
In the past we've been able to assume that all packages which had
metadata JSON files had shipped from our repos/engsys and had a
`DirectoryPath` field with useful information in it. In the case of ToC,
we use that `DirectoryPath` field to arrive at a package-level readme
filename for use in the ToC. However, if that field is empty we want to
fall back on other heuristics of arriving at the filename.

Sample broken build:
https://dev.azure.com/azure-sdk/internal/_build/results?buildId=2824162&view=logs&j=dc056dfc-c0cf-5958-c8c4-8da4f91a3739&t=51aa7976-5924-5040-41de-f124a4debc20&l=162

Sample working build:
https://dev.azure.com/azure-sdk/internal/_build/results?buildId=2827344&view=logs&j=dc056dfc-c0cf-5958-c8c4-8da4f91a3739
(canceled before it kicks off the daily docs build, that's not relevant
here)

Changes to reference-unified.yml --
ed17e68454 (diff-594596e7bb045eeccea024715d4bb660b147569f1de067a3ed9d27d7a8dc4992)
... Note no erroneous `/-readme.md` in the `href` fields for services,
this is what would have happened if the errors were directly checked in.
2023-06-13 17:32:38 +00:00
Daniel Jurek 16e0346e12
Add rex-tool-tests.json for shared tests with docs team (#25822)
Add REX tool shared tests specifications
2023-05-11 14:48:13 -07:00
Mary Gao 2d6f28bf1e
Update getstarted doc (#25318)
fixes https://github.com/Azure/azure-sdk-for-js/issues/25310
2023-03-21 20:27:33 +08:00
Jeremy Meng 90df6515ca
[engsys] improve bot filed dep issue description (#25231)
- linkify the npm package name for easier jump to the npmjs page of the
package
2023-03-15 15:45:37 -04:00
Jose Manuel Heredia Hidalgo aabe42dade
Setup cross language cadl compile (#24661)
This PR does the one-time setup needed to run cadl scripts to generate code. The documentation on how to use the scripts here: https://github.com/Azure/azure-sdk-tools/blob/main/doc/common/Cadl-Project-Scripts.md#per-project-setup
2023-03-11 00:52:18 +00:00
Mike Harder 54bdf4e20d
Update location of strictPeerDependencies config setting (#24768)
- Fixes #24748
- Continuation of #24644
2023-02-07 22:17:50 +00:00
Praven Kuttappan 68eb0ccf67
Remove api parser rebuild step (#24728)
Install required packages before building api parser
2023-02-06 12:59:50 -05:00
Sima Zhu a4755d5421
Add 'deprecated' to toc display name (#24315) 2022-12-27 09:39:39 -08:00
Praven Kuttappan 401dca4ff2
Enforce package name approval status for preview version (#23897) 2022-11-18 12:19:08 -05:00
praveenkuttappan 64aab211ac
remove strict mode to unblock scheduled pipeline runs (#23230)
* remove strict mode to unblock scheduled pipeline runs
2022-09-15 22:22:53 +00:00
praveenkuttappan 339e175200
Generate APIView code file as part of build pipeline job and publish … (#22857)
* Generate APIView code file as part of build pipeline job and publish it as artifact
2022-09-15 16:16:12 -04:00
Sima Zhu ef63ca8aef
Use the right var for package info (#22636) 2022-07-19 12:22:03 -07:00
Sima Zhu 5fd557bc43
Enable service level readme generation for daily docs. (#22265) 2022-07-18 14:28:14 -07:00
praveenkuttappan a92e108cb7
Smoke test is not getting correct tag after GA release (#21339)
* Smoke test is not getting correct tag after GA release
2022-05-27 16:52:48 -04:00
Patrick Hallisey 444dc5c673
Fix $package variable in docs ms validation function (#21545) 2022-04-21 20:31:13 +00:00
praveenkuttappan 32d525d33b
Release check is failing for package when only one alpha version is presenton npm (#21521) 2022-04-21 15:41:12 -04:00
Patrick Hallisey 0416070da3
Add support for batched DocMS validation (#21483) 2022-04-20 12:25:47 -07:00
Matthew Podwysocki 2230ad9cc7
[core] Remove @azure/core-asynciterator-polyfill usage (#21290)
* Remove @azure/core-asynciterator-polyfill usage

* Remove @azure/core-asynciterator-polyfill usage

* Remove from workspace too

* Remove from core artifacts list

* Make eslint happy

* Fix more eslint errors

Co-authored-by: Jeremy Meng <yumeng@microsoft.com>
2022-04-11 14:17:23 -07:00
Daniel Jurek d958c7e29a
Readd @azure/communication-react (#21252) 2022-04-06 18:50:37 -07:00
praveenkuttappan 24394056b0
Do not overwrite existing labels on auto generated dependency upgrade… (#20953)
* Do not overwrite existing labels on auto generated dependency upgrade issue
2022-03-22 15:49:57 -04:00
Daniel Jurek a2918619ae
Add ToC Generation script and wire up to docindex.yml (#19915)
* Add ToC Generation script and wire up to docindex.yml for testing

Add Docs-ToC.ps1

Remove eng/scripts/docs from .gitignore but keep filtering other docs/ folders

Also checkout packages-legacy.json in sparse checkout

Also check out docs-ref-mapping/

Use -toc-test branch for demo

Review feedback

Review feedback

Remove unnecessary comment

Undo working changes

Add extension point to update the ToC before output

Undo changes to demo set-daily-docs-branch-name.yml

Check for FileMetadata before accessing it

Add ability to artbitarily nest packages in the 'Other' service.

Add comments from review feedback

Add plugin nodes

* Revert unnecessary changes to eng/common

* Review feedback

* Remove automatic ToC generation from main

* Set-StrictMode

* Remove Release-DocsMsDocs.ps1

* Use original syntax
2022-03-01 07:46:36 -08:00
Daniel Jurek 3c757198c1
Add @azure/communication-react to (#20575) 2022-02-28 23:06:40 +00:00
Jose Manuel Heredia Hidalgo d5e4c233fb
Deprecate unused packages (#20295) 2022-02-09 14:42:55 -08:00
praveenkuttappan 8d27ce2148
Include instructions to upgrade package dependency in auto filed issues (#20099)
* Update issue description and labels for package dependency upgrade issues
2022-02-02 13:41:54 -05:00
praveenkuttappan 1af9322b9a
Automate filing issues for any external package dependency (#19076)
* Automate filing issues for any external package dependency and deprecation
2021-12-13 11:19:38 -05:00
Sima Zhu d5276ea729
Update docsms packages (#19009) 2021-12-09 19:19:31 -08:00
Daniel Jurek 10dd822322
Spell Check Phase 2 (#17142)
* Add update cspell.json, add exceptions to opt out services with spelling errors

Turn on spell check failures in CI

Add opted out services

Update words list, sort, fix syntax

Add more exceptions

progress

Use current cspell.json

* Add spell check enforcement for public API surface area

* Exclude checking spelling in sdk/test-utils

* Add automation for spell checking the public API surface to aggregate-reports and analyze job

* Remove -ServiceDirectory parameter from aggregat-reports

* Add engsys spelling exceptions

* Do not fail analyze step on spelling errors in modified files

* npx

* Opt out the generated packages

* Add spell checking and failure for public API surface (pre opt-out)

* Improve error logging and spelling error report

* Pin cspell version

* Use Invoke-Cspell.ps1 to pin cspell version

* Use Invoke-Expression and multiple --package entries to pin cspell and dictionary to expected version

* Use npm exec strategy for Invoke-Cspell.ps1

* Move Set-Location

* Use simplified Get-ChildItem

* Apply suggestions from code review

Co-authored-by: Wes Haggard <weshaggard@users.noreply.github.com>

* Add exclusions for packages which have cspell spelling error detections

* Update eng/common/spelling/Invoke-Cspell.ps1

Co-authored-by: Wes Haggard <weshaggard@users.noreply.github.com>

* Variable naming

* Add ability to use LICENSE[.txt] file instead of generating a file, add MSRC to words list

* Get NPM info

* Upgrade NPM

* Parentheses

* Variables

* Remove spelling error temporarily

* Revert "Remove spelling error temporarily"

This reverts commit dd681aca1203e364f36ca82d3acf0bd03d27e20c.

* Attempt to fix link

* Aggregate reports should use version of npm compatible with Node 10.x

* Perform Node/NPM upgrades manually in aggregate-reports.yml, put Node/NPM upgrade directly into check-spelling.yml template in eng/common so it gets used everywhere

* Remove redundant use-node-version.yml

* Move NPM version switch to fix aggregate-reports

* Do not mutate local NPM environment

* Revert incorrect proposed changes to eng/common

* Clean up opted out entries, exclude arm-* which are already excluded in another glob

* Globals template is not needed because use-node-version.yml specifies a node version to use

* Use use-node-version.yml

* Use new exclusion globs

Co-authored-by: Wes Haggard <weshaggard@users.noreply.github.com>
2021-12-06 14:39:32 -08:00
Chidozie Ononiwu (His Righteousness) 4b9ef51319
Add better logging to GetExistingPackageVersions (#18704) 2021-11-16 16:35:55 -08:00
Sima Zhu 6f2d579351
Use docker to validate packages in js docindex (#18405) 2021-11-04 22:13:56 -07:00