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

Fix readme v0.1 rc2 #8

Merged
merged 2 commits into from
Oct 29, 2024
Merged

Fix readme v0.1 rc2 #8

merged 2 commits into from
Oct 29, 2024

Conversation

wvenialbo
Copy link
Owner

@wvenialbo wvenialbo commented Oct 29, 2024

Summary by Sourcery

Update the README to provide clearer installation instructions and detailed examples for downloading data from various NOAA archives using the GOES-DL package.

Documentation:

  • Update installation instructions in the README to reflect the availability of the package via pip.
  • Clarify the data source for GOES 2nd and 3rd Generation Data and GridSat-B1 Data in the README.
  • Add detailed examples for downloading data from NOAA's AWS and NCEI archives in the README.

Copy link

sourcery-ai bot commented Oct 29, 2024

Reviewer's Guide by Sourcery

This PR updates the README.md file to improve documentation clarity and provide more detailed examples for using the GOES-DL package. The changes include adding repository paths to examples, clarifying data source locations, and adding a new example for downloading GridSat-B1 data from NOAA's NCEI archive.

No diagrams generated as the changes look simple and do not need a visual representation.

File-Level Changes

Change Details Files
Updated installation instructions and section headers
  • Removed '(not yet)' note from pip installation instructions
  • Added clarification about data sources in section headers
README.md
Enhanced code examples with repository configuration
  • Added repository path parameters to all datasource initializations
  • Added cache configuration example for GOES-R Series data
  • Added explanatory comments about file caching behavior
README.md
Added new example section for GridSat-B1 NCEI archive
  • Created new section showing how to download GridSat-B1 data from NCEI archive
  • Added explanation about shared folder structure between AWS and NCEI archives
README.md

Tips and commands

Interacting with Sourcery

  • Trigger a new review: Comment @sourcery-ai review on the pull request.
  • Continue discussions: Reply directly to Sourcery's review comments.
  • Generate a GitHub issue from a review comment: Ask Sourcery to create an
    issue from a review comment by replying to it.
  • Generate a pull request title: Write @sourcery-ai anywhere in the pull
    request title to generate a title at any time.
  • Generate a pull request summary: Write @sourcery-ai summary anywhere in
    the pull request body to generate a PR summary at any time. You can also use
    this command to specify where the summary should be inserted.

Customizing Your Experience

Access your dashboard to:

  • Enable or disable review features such as the Sourcery-generated pull request
    summary, the reviewer's guide, and others.
  • Change the review language.
  • Add, remove or edit custom review instructions.
  • Adjust other review settings.

Getting Help

Copy link
Contributor

deepsource-io bot commented Oct 29, 2024

Here's the code health analysis summary for commits e49ad63..d39b1c4. View details on DeepSource ↗.

Analysis Summary

AnalyzerStatusSummaryLink
DeepSource Python LogoPython✅ SuccessView Check ↗
DeepSource Test coverage LogoTest coverage⚠️ Artifact not reportedTimed out: Artifact was never reportedView Check ↗

💡 If you’re a repository administrator, you can configure the quality gates from the settings.

@wvenialbo wvenialbo merged commit 2dbb693 into develop Oct 29, 2024
1 of 11 checks passed
Copy link

@sourcery-ai sourcery-ai bot left a comment

Choose a reason for hiding this comment

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

Hey @wvenialbo - I've reviewed your changes and they look great!

Here's what I looked at during the review
  • 🟢 General issues: all looks good
  • 🟢 Security: all looks good
  • 🟢 Testing: all looks good
  • 🟢 Complexity: all looks good
  • 🟡 Documentation: 2 issues found

Sourcery is free for open source - if you like our reviews please consider sharing them ✨
Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.

datasource = DatasourceAWS(locator)
# GOES-16 data is updated every 10 minutes. If you are downloading
# old data, you may leave the cache refresh rate as default (+inf).
datasource = DatasourceAWS(locator, repository="./my_data/goes-r", cache=600)
Copy link

Choose a reason for hiding this comment

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

suggestion (documentation): Consider explaining the cache parameter's default value

The comment mentions '+inf' as the default value, but this might not be clear to all users. Consider adding a note about what this means in practice.

# GOES-16 data is updated every 10 minutes. If you are downloading
# old data, the default cache setting (infinite) means files will
# only be downloaded once and kept indefinitely.
datasource = DatasourceAWS(locator, repository="./my_data/goes-r", cache=600)

end="1984-08-24T00:00-0004",
)

# `files1` and files2` are lists of tuple[str, bytes] with file path and
Copy link

Choose a reason for hiding this comment

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

issue (documentation): Fix missing backtick in files2 variable name

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.

1 participant