Alert notification API

[nicholaspcr]

Summary

References https://github.com/TheThingsIndustries/lorawan-stack/pull/3911
References https://github.com/TheThingsIndustries/product-management/issues/4

Introduces the documentation of Alert Notification API present on IS.

Screenshots

screenshots

Gateway.md update

IS API

profile CLI

Receivers CLI

Changes

• Add the new generated doc files from ttes.
• Update API definition for IS
• Add AlertNotificationProfileIdentifiers message to gateway's API section.
• Update ttn-lw-cli.json to include new experimental CLI commands on the command line interface documentation section.

Notes for Reviewers

Checklist

• Scope: The referenced issue is addressed, there are no unrelated changes.
• Run Locally: Verified that the docs build using make server, posted screenshots, verified external links. Test with HUGO_PARAMS_SEARCH_ENABLED=true if style changes will affect the search bar.
• New Features Marked: Documentation for new features is marked using the new-in-version shortcode, according to the guidelines in CONTRIBUTING.
• Style Guidelines: Documentation obeys style guidelines in CONTRIBUTING.
• Commits: Commit messages follow guidelines in CONTRIBUTING, there are no fixup commits left.

[KrishnaIyer]

I think this PR should either go also to a feature branch or be held until the feature is complete and this PR covers the full functionality.

[nicholaspcr]

I agree, left it as a draft with the intention of only merging it when the PR referenced goes into a release.

Will do the same process as what is done on enterprise, change the target to a feature branch.

[nicholaspcr]

With the previous topic more defined, I'll make this PR ready for review after the api section of the PR is approved.
Avoiding duplicate work every time an API change is requested

[nicholaspcr]

@nejraselimovic could you give me a hand with an error I'm having on these changes?

After changing doc/data/commands/ttn-lw-cli.json I'm getting a bunch of REF_NOT_FOUND errors in CLI command files, which are not related to the new commands, and I can't identify what am I'm doing wrong.

Full error example:

ERROR 2023/11/02 19:27:14 [en] REF_NOT_FOUND: Ref "ttn-lw-cli/ttn-lw-cli_alert-notification-receivers_get" from page "ttn-lw-cli/ttn-lw-cli_users_set.md": page not found

[nejraselimovic]

@nejraselimovic could you give me a hand with an error I'm having on these changes?

After changing doc/data/commands/ttn-lw-cli.json I'm getting a bunch of REF_NOT_FOUND errors in CLI command files, which are not related to the new commands, and I can't identify what am I'm doing wrong.

Full error example:

ERROR 2023/11/02 19:27:14 [en] REF_NOT_FOUND: Ref "ttn-lw-cli/ttn-lw-cli_alert-notification-receivers_get" from page "ttn-lw-cli/ttn-lw-cli_users_set.md": page not found

/doc/data/commands is being auto-generated with every new release, so I think you shouldn't be adding that manually? See release docs template

[nicholaspcr]

/doc/data/commands is being auto-generated with every new release, so I think you shouldn't be adding that manually? See release docs template

@nejraselimovic thanks, missed this somehow and was a bit lost.
Silly mistake on my end and I appreciate you taking your time to help me.

[nejraselimovic]

To me it looks good, docs are building correctly, but I suggest you wait for another reviewers' approval just in case I'm missing something

[adriansmares]

LGTM.

I think some of the changes here are part of #1206 , which wasn't available when this branch was created. I suggest rebasing on top of master both the feature branch and this branch.