Skip to content

Update large-assets.md#131

Open
ltclm wants to merge 1 commit intomasterfrom
update_large_asset_download_doc
Open

Update large-assets.md#131
ltclm wants to merge 1 commit intomasterfrom
update_large_asset_download_doc

Conversation

@ltclm
Copy link
Copy Markdown
Contributor

@ltclm ltclm commented Mar 31, 2026

Change "How It Works" to better distinguish between the probe and download steps.
provided by @CaptainInler

Test link

Change "How It Works" to better distinguish between the probe and
download steps.
provided by @CaptainInler
Copy link
Copy Markdown
Contributor

@asteiner-swisstopo asteiner-swisstopo left a comment

Choose a reason for hiding this comment

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

I like the overview given at the beginning. I would at least fix the typo ("this --> "these") or rephrase certain certain parts for clarity 🙃

The workaround is to use **HTTP range requests**, which bypass the CloudFront limit by fetching the file in sequential chunks directly from the S3 origin.

## How It Works
The actual download is completed in this steps:
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🤔 Not sure I understand this sentence. Also, it is usually clearer to use active voice instead of passive.

How about this instead?

Suggested change
The actual download is completed in this steps:
Downloading a large asset involves three steps that we detail in the following subsections:


You can probe an asset manually with `curl`:
Example to probe an asset manually with `curl` on Linux:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Why "on Linux"? In my understanding, curl is also available on Windows.

:::

## Download Script
## Download
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

I find it confusing that the first title follows what is written in the list and the second does not

The list:

  1. Probe the asset
  2. Download the file in chunks
  3. Optional: Verify SHA‑256 checksum

The titles:

## Probe the asset
## Download

How about making the titles consistent with the list?

## 1. Probe the asset
## 2. Download the file in chunks

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.

2 participants