Azure / Azure/azure-sdk-for-python

[docs] Fix broken systemperf install path in perfstress_tests.md

オープン
#48,699 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る
agentic-workflows automated documentation
主要言語
Python
スター
5.6k
フォーク
3.4k
平均マージ
2日 2時間
マージ済み PR(30日)
213

説明

## Summary

Reviewed all 55 markdown files under `doc/` for inconsistencies with the current source code and repository structure. One broken path was found and fixed.

## Change

**File:** `doc/dev/perfstress_tests.md`

**Before:**
```
pip install -e azure-sdk-for-python/tools/devtools_testutils[systemperf]
```

**After:**
```
pip install -e azure-sdk-for-python/eng/tools/azure-sdk-tools[systemperf]
```

**Why:** The `devtools_testutils` package was relocated from `tools/devtools_testutils/` to `eng/tools/azure-sdk-tools/`. The old path no longer exists in the repository, so anyone following this instruction would get a "no such file or directory" error. The `systemperf` optional dependency is defined in `eng/tools/azure-sdk-tools/pyproject.toml`, confirming the correct path.

## Other files checked (no changes needed)

- **`tox` references:** None found — docs already use `azpysdk` throughout.
- **`setup.py` references:** All contextually appropriate — appear only in legacy-package notes alongside `pyproject.toml` as the modern alternative.
- **Broken internal links:** None — all image and `.md` cross-references resolve correctly.
- **Contradictions between docs:** None found.
- **Stale package/path references:** Only the one fixed above.

> Generated by [Documentation Consistency Check](https://github.com/Azure/azure-sdk-for-python/actions/runs/32691838976) · 122.4 AIC · ⌖ 11.9 AIC · ⊞ 5.8K · [◷](https://github.com/search?q=repo%3AAzure%2Fazure-sdk-for-python+%22gh-aw-workflow-id%3A+doc-consistency-check%22&type=pullrequests)

---

> [!NOTE]
> This was originally intended as a pull request, but GitHub Actions is not permitted to create or approve pull requests in this repository.
> The changes have been pushed to branch `docs/fix-perfstress-install-path-201f0f86227b27d5`.
>
> **[Click here to create the pull request](https://github.com/Azure/azure-sdk-for-python/compare/main...docs/fix-perfstress-install-path-201f0f86227b27d5?expand=1&title=%5Bdocs%5D%20Fix%20broken%20systemperf%20install%20path%20in%20perfstress_tests.md)**

To fix the permissions issue, go to **Settings** → **Actions** → **General** and enable **Allow GitHub Actions to create and approve pull requests**. See also: [gh-aw FAQ](https://github.github.com/gh-aw/reference/faq/#why-is-my-create-pull-request-workflow-failing-with-github-actions-is-not-permitted-to-create-or-approve-pull-requests)

Show patch (30 lines)

```diff
From afafceb3699f15ce7cf8248fcee9753b936554c3 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
Date: Mon, 24 Aug 2026 05:03:18 +0000
Subject: [PATCH] Fix broken install path in perfstress_tests.md

Update systemperf extra install path from tools/devtools_testutils to
eng/tools/azure-sdk-tools, which is the current location of the package.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
doc/dev/perfstress_tests.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/dev/perfstress_tests.md b/doc/dev/perfstress_tests.md
index c0f7fa85..fe3ded40 100644
--- a/doc/dev/perfstress_tests.md
+++ b/doc/dev/perfstress_tests.md
@@ -486,7 +486,7 @@ If your tests are not being discovered, run the `perfstressdebug` command instea
The system tests are used to test the performance of the Python HTTP layers exclusive of the Azure SDK in order to set a performance benchmark.
In order to run these, you will need a Python environment with `systemperf` flavour of `devtools_testutils` installed. Installing to a fresh Python environment is recommended.
```cmd
-(env) ~/> pip install -e azure-sdk-for-python/tools/devtools_testutils[systemperf]
+(env) ~/> pip install -e azure-sdk-for-python/eng/tools/azure-sdk-tools[systemperf]
```
Once these dependencies are installed, the `systemperf` command can be run directly to list the available tests:
```cmd
--
2.54.0

```

コントリビューションガイド

コントリビューションガイドを開く

調査の方向性

doc/dev/perfstress_tests.md を開き、systemperf のインストール コマンドと eng/tools/azure-sdk-tools/pyproject.toml にあるパッケージの場所を比較します。記載されているパスがリポジトリの構造と一致していること、およびインストール後に systemperf コマンドを実行できることを確認します。tools/devtools_testutils の古いパスが記載されなくなれば完了です。

索引モデルが issue の本文から書いたものです。

評価

技術スタック
python
領域
documentation
issue の種類
ドキュメント
難易度
1/5
見積もり時間
1時間未満
活発さ
活発
明瞭さ
明確に書かれている
初心者へのやさしさ
25/100

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。