googleapis / googleapis/google-cloud-python

Use of colon and line break in doc string breaks formatting in IntelliSense

Đang mở
#13,793 2 bình luận 0 reaction 0 người được giao Xem trên GitHub
priority: p3 type: docs
Ngôn ngữ chính
Python
Star
5.4k
Fork
1.8k
Merge trung bình
3 ngày 4 giờ
Pull request đã merge (30 ngày)
122

Mô tả

### Determine this is the right repository

- [x] I determined this is the correct repository in which to report this bug.

### Summary of the issue

**Context**
[These lines](https://github.com/googleapis/google-cloud-python/blob/4f87fe6583a44d0de55a951a51b00e95d6eceee0/packages/google-cloud-secret-manager/google/cloud/secretmanager_v1/services/secret_manager_service/client.py#L617-L621) cause bad formatting of doc string in IntelliSense hints in IDE. This is due to the use of a `:` and a line break.

**Expected Behavior:**
Readable doc string information within IDE tool tip

**Actual Behavior:**
Inconsistent text formatting.

Image

### API client name and version

_No response_

### Reproduction steps: code

_No response_

### Reproduction steps: supporting files

_No response_

### Reproduction steps: actual results

_No response_

### Reproduction steps: expected results

_No response_

### OS & version + platform

_No response_

### Python environment

_No response_

### Python dependencies

_No response_

### Additional context

_No response_

Hướng dẫn đóng góp

Mở hướng dẫn đóng góp

Đánh giá

Issue này chưa được đánh giá.

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.