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

Add documentation button #57

Merged
merged 2 commits into from
Dec 5, 2024
Merged

Add documentation button #57

merged 2 commits into from
Dec 5, 2024

Conversation

FilipZajdel
Copy link
Contributor

@FilipZajdel FilipZajdel commented Dec 5, 2024

Add a new optional property 'docsUrl' to the index schema that allows to set the documentation's url. In case it isn't used, the readme is automatically linked. If the readme does not exist, the repo url is linked.

Also add the link for Thingy 91X documentation.

VSC-2602
VSC-2776

image

Add a new optional property 'docsUrl' to the index schema that allows to
set the documentation's url. In case it isn't used, the readme is
automatically linked. If the readme does not exist, the repo url
is linked.
@FilipZajdel FilipZajdel changed the title Add a new button linked to documentation Add documentation button Dec 5, 2024
Copy link
Contributor

@greg-fer greg-fer left a comment

Choose a reason for hiding this comment

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

Nice addition!
Will the button wording and icon change if it is linking to the add-on's repository instead of a README or docs? Having "Documentation" and its icon for the pure repo link might suggest the docs are missing by mistake, which might not be the case -- their lack could be intentional.

@@ -120,6 +120,10 @@ export const appMetadataSchema = {
type: 'string',
description: 'The default git branch that the repository is checked out. Inferred from the repo if missing.'
},
docsUrl: {
type: 'string',
description: `The url of the addon's documentation`
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
description: `The url of the addon's documentation`
description: `The URL of the add-on's documentation`

Copy link

@kylebonnici kylebonnici left a comment

Choose a reason for hiding this comment

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

Looks good to me. Will let @greg-fer also give his input as well

scripts/validate-index.ts Outdated Show resolved Hide resolved
@FilipZajdel
Copy link
Contributor Author

FilipZajdel commented Dec 5, 2024

Nice addition! Will the button wording and icon change if it is linking to the add-on's repository instead of a README or docs? Having "Documentation" and its icon for the pure repo link might suggest the docs are missing by mistake, which might not be the case -- their lack could be intentional.

I added the link to the repo as the last resort fallback in case there is neither docsUrl nor README. If that's confusing I suggest hiding the button completely. What do you think?

@greg-fer
Copy link
Contributor

greg-fer commented Dec 5, 2024

Nice addition! Will the button wording and icon change if it is linking to the add-on's repository instead of a README or docs? Having "Documentation" and its icon for the pure repo link might suggest the docs are missing by mistake, which might not be the case -- their lack could be intentional.

I added the link to the repo as the last resort fallback in case there is neither docsUrl nor README. If that's confusing I suggest hiding the button completely. What do you think?

Sounds good!

@FilipZajdel FilipZajdel requested a review from greg-fer December 5, 2024 10:30
@FilipZajdel FilipZajdel added this pull request to the merge queue Dec 5, 2024
Merged via the queue into main with commit 596d8da Dec 5, 2024
3 checks passed
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.

3 participants