Skip to content

Fixed wrong docu about STAC create asset#128

Merged
ltshb merged 3 commits intomasterfrom
bug-stac-post
Mar 19, 2026
Merged

Fixed wrong docu about STAC create asset#128
ltshb merged 3 commits intomasterfrom
bug-stac-post

Conversation

@ltshb
Copy link
Copy Markdown
Contributor

@ltshb ltshb commented Mar 19, 2026

Creating new STAC asset can only be done by PUT not by POST.

Also fixed some dependencies vulnerabilities by running npm audit fix

Test link

ltshb added 2 commits March 19, 2026 08:09
Creating new STAC asset can only be done by PUT not by POST.
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.

Nice improvement, thanks. I just had some minor comments/questions.

Comment thread releases/20240313.md Outdated
# Release 20240313 - Wednesday, March 13th 2024

### API & applications
## API & applications
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.

Makes sense but then it's inconsistent with all the others. Probably could be removed altogether - the section is empty for every release 🤷 I would either remove it everywhere (and sync with the DI team) or leave it as it is.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Ok then I leave it as is

curl --request POST \
--url https://data.geoadmin.ch/api/stac/v1/collections/ch.swisstopo.swisstlmregio/items/swisstlmregio-2020/assets \
curl --request PUT \
--url https://data.geoadmin.ch/api/stac/v1/collections/ch.swisstopo.swisstlmregio/items/swisstlmregio-2020/assets/fancy_unique_id \
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.

The rest of the example uses concrete names (like ch.swisstopo.swisstlmregio), not placeholders. So I would suggest to replace fancy_unique_id with an actual asset name/ID in that collection.

Comment thread package-lock.json
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.

For my understanding, why doesn't Renovate update this accordingly and you had to use npm audit fix?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

I have no idea about renovate, @KeeTraxx. I run audit because when I installed the dependencies I had some vulnerabilities warnings.

@ltshb ltshb merged commit dabc5eb into master Mar 19, 2026
2 checks passed
@ltshb ltshb deleted the bug-stac-post branch March 19, 2026 09:12
asteiner-swisstopo added a commit that referenced this pull request Mar 19, 2026
This is a follow-up of [a PR comment](#128 (comment)).

I have noticed that all release pages follow this structure:

```txt

- Bug fixes
- Announcements:
  - Announcement 1
  - Announcement 2

- [Full changelog][https://link]

```

I see three issues with that:

1. Inconsistent formatting: The heading levels jump from h1 (#) directly to h3 (###). Proper markdown does not skip heading levels.
2. "API & applications": Empty on all pages, not clear what is its purpose.
3. "Bug fixes": It's empty for all pages except 20250514. Removing it along with the "Announcements" reduces the list nesting.

To focus on the content, I propose to simplify the structure to this:

```txt

- Announcement 1
- Announcement 2
- [Full changelog][https://link]

```

The change in heading levels also requires changing the script for the "All releases" page.
asteiner-swisstopo added a commit that referenced this pull request Mar 19, 2026
This is a follow-up of [a PR comment](#128 (comment)).

I have noticed that all release pages follow this structure:

```txt

- Bug fixes
- Announcements:
  - Announcement 1
  - Announcement 2

- [Full changelog][https://link]

```

I see three issues with that:

1. Inconsistent formatting: The heading levels jump from h1 (#) directly to h3 (###). Proper markdown does not skip heading levels.
2. "API & applications": Empty on all pages, not clear what is its purpose.
3. "Bug fixes": It's empty for all pages except 20250514. Removing it along with the "Announcements" reduces the list nesting.

To focus on the content, I propose to simplify the structure to this:

```txt

- Announcement 1
- Announcement 2
- [Full changelog][https://link]

```

The change in heading levels also requires changing the script for the "All releases" page.
asteiner-swisstopo added a commit that referenced this pull request Mar 19, 2026
This is a follow-up of [a PR comment](#128 (comment)).

I have noticed that all release pages follow this structure:

```txt
\# Release title

\### API & applications

\### API

- Bug fixes
- Announcements:
  - Announcement 1
  - Announcement 2

- [Full changelog][https://link]

\### Geodata
```

I see three issues with that:

1. Inconsistent formatting: The heading levels jump from h1 (#) directly to h3 (###). Proper markdown does not skip heading levels.
2. "API & applications": Empty on all pages, not clear what is its purpose.
3. "Bug fixes": It's empty for all pages except 20250514. Removing it along with the "Announcements" reduces the list nesting.

To focus on the content, I propose to simplify the structure to this:

```txt
\# Release title

\## API
- Announcement 1
- Announcement 2
- [Full changelog][https://link]

\## Geodata
```

The change in heading levels also requires changing the script for the "All releases" page.
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