Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update the Python Quickstart README #1326

Merged
merged 4 commits into from
Dec 15, 2023

Conversation

feorlen
Copy link
Contributor

@feorlen feorlen commented Nov 3, 2023

Improve the Python Quickstart:

  • Add a minimal client example
  • Clarify the steps to run the file uploader example.
  • Update text and formatting to more closely match the MinIO docs.

Since this repo doesn't use the Docs staging server, this direct link in GitHub is an easier way to see an overview of changes than reading the diff:
https://github.com/feorlen/minio-py/blob/readme-quickstart-update/README.md

This update roughly follows the structure of the minio-go README.

Corresponding docs issue: minio/docs#1042

README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
@feorlen
Copy link
Contributor Author

feorlen commented Nov 6, 2023

@balamurugana Appreciate the comments! I will revisit the content with this in mind.

From a documentation perspective, it is helpful to have the examples in the different SDKs be as similar as possible. That doesn't always fit with needs/practices of different languages of course, sometimes takes a bit of experimentation to find the correct balance.

@feorlen
Copy link
Contributor Author

feorlen commented Nov 7, 2023

@balamurugana I've reworked the entire page based on our conversation. I've retained some of the descriptive text and streamlined other parts. When you have a moment, I'd appreciate a look and if this approach seems useful for both less and more knowledgeable types of readers. It's closer to the original, but with some additional context for a novice/casual reader.

@@ -0,0 +1,9 @@
MinIO Cloud Storage, (C) 2014-2023 MinIO, Inc.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added and linked to this along with the license


client = Minio("play.min.io",
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Perhaps this is more practical, less verbose yet still some additional context for novice readers.

@harshavardhana
Copy link
Member

PTAL @balamurugana

@minio-trusted
Copy link
Contributor

PTAL @balamurugana

Bump @balamurugana this is waiting on your review - can you please take a look?

@harshavardhana harshavardhana merged commit 977c399 into minio:master Dec 15, 2023
18 checks passed
@feorlen feorlen deleted the readme-quickstart-update branch December 15, 2023 23:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants