GoogleCloudPlatform / GoogleCloudPlatform/gsutil
Feature Request: Document Cloud Storage doesn't validate the existence of logging_bucket in gsutil logging set on command
- Dominant language
- Python
- Stars
- 918
- Forks
- 335
- PR merge metrics
- No merged PRs in 30d
Description
https://github.com/GoogleCloudPlatform/gsutil/blob/master/gslib/commands/logging.py#L57
From:
```
logging_bucket must already exist, and all URLs must name
buckets (e.g., gs://bucket).
```
to:
```
Cloud Storage doesn't validate the existence of logging_bucket so users should ensure it already exists, and all URLs must name buckets (e.g., gs://bucket).
```
Contributor guide
Research direction
Start at gslib/commands/logging.py around line 57, where the logging_bucket guidance is documented. Update the wording to explain that Cloud Storage does not validate the bucket's existence and that users should ensure it exists, while preserving the URL requirement. Done means the command documentation matches the requested text.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- google-cloud, python
- Domain
- cli, documentation
- Issue type
- Documentation
- Difficulty
- 1/5
- Estimated time
- Under an hour
- Activity status
- Stale
- Clarity
- Clearly specified
- Newbie friendliness
- 55/100