Skip to content

Create SchemaGuideLink with an icon that points to the schema guide#441

Merged
abelsiqueira merged 4 commits intomainfrom
439-link-to-schema
May 11, 2022
Merged

Create SchemaGuideLink with an icon that points to the schema guide#441
abelsiqueira merged 4 commits intomainfrom
439-link-to-schema

Conversation

@abelsiqueira
Copy link
Copy Markdown
Collaborator

Pull request details

Includes an i icon at each page question linking to the corresponding schema field

List of related issues or pull requests

Refs:

Describe the changes made in this pull request

Instructions to review the pull request

@abelsiqueira abelsiqueira marked this pull request as ready for review December 6, 2021 16:34
Comment thread src/components/SchemaInfoIcon.vue Outdated
@@ -0,0 +1,25 @@
<template>
<a v-bind:href="'https://github.com/citation-file-format/citation-file-format/blob/main/schema-guide.md#' + section">
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
<a v-bind:href="'https://github.com/citation-file-format/citation-file-format/blob/main/schema-guide.md#' + section">
<a v-bind:href="'https://github.com/citation-file-format/citation-file-format/blob/1.2.0/schema-guide.md' + anchor">
  • main -> 1.2.0 for more predictable results
  • changed section to anchor, I believe that's what that is called (needs verification). Also I moved the # to be part of what components use, this makes it easier to recognize how that piece of data is used in my opinion

Comment thread src/components/SchemaInfoIcon.vue Outdated
export default defineComponent({
name: 'SchemaInfoIcon',
props: {
section: {
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
section: {
anchor: {

Comment thread src/components/ScreenAbstract.vue Outdated
<div id="form-content">
<p class="question">
What is the abstract of the work?
<SchemaInfoIcon section="abstract" />
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
<SchemaInfoIcon section="abstract" />
<SchemaInfoIcon anchor="#abstract" />

Comment thread src/components/ScreenAuthors.vue Outdated
<div id="form-content">
<p class="question">
Who are the author(s) of the work?
<SchemaInfoIcon section="authors" />
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
<SchemaInfoIcon section="authors" />
<SchemaInfoIcon anchor="#authors" />

Comment thread src/components/ScreenIdentifiers.vue Outdated
>
schema guide
</a> for examples.
<SchemaInfoIcon section="identifiers" />
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
<SchemaInfoIcon section="identifiers" />
<SchemaInfoIcon anchor="#identifiers" />

Comment thread src/components/ScreenKeywords.vue Outdated
<div id="form-content">
<p class="question">
What keywords describe the work?
<SchemaInfoIcon section="keywords" />
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
<SchemaInfoIcon section="keywords" />
<SchemaInfoIcon anchor="#keywords" />

Comment thread src/components/ScreenLicense.vue Outdated
<div id="form-content">
<p class="question">
What is the license of the work?
<SchemaInfoIcon section="license" />
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
<SchemaInfoIcon section="license" />
<SchemaInfoIcon anchor="#license" />

<div id="form-content">
<p class="question">
What is the URL of the work in a source code repository?
<SchemaInfoIcon section="repository-code" />
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
<SchemaInfoIcon section="repository-code" />
<SchemaInfoIcon anchor="#repository-code" />


<p class="question">
What is the URL of a landing page/website for the work?
<SchemaInfoIcon section="url" />
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
<SchemaInfoIcon section="url" />
<SchemaInfoIcon anchor="#url" />


<p class="question">
What is the URL of the work in a repository?
<SchemaInfoIcon section="repository" />
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
<SchemaInfoIcon section="repository" />
<SchemaInfoIcon anchor="#repository" />


<p class="question">
What is the URL of the work in a build artifact/binary repository?
<SchemaInfoIcon section="repository-artifact" />
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
<SchemaInfoIcon section="repository-artifact" />
<SchemaInfoIcon anchor="#repository-artifact" />

Comment thread src/components/ScreenStart.vue Outdated
<div id="form-content">
<p class="question">
What is the title of the work?
<SchemaInfoIcon section="title" />
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
<SchemaInfoIcon section="title" />
<SchemaInfoIcon anchor="#title" />

Comment thread src/components/ScreenStart.vue Outdated
/>
<p class="question">
What do you want citers to do with the information provided in your CITATION.cff file?
<SchemaInfoIcon section="message" />
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
<SchemaInfoIcon section="message" />
<SchemaInfoIcon anchor="#message" />

Comment thread src/components/ScreenStart.vue Outdated
</q-input>
<p class="question">
What type of work does this CITATION.cff describe?
<SchemaInfoIcon section="type" />
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
<SchemaInfoIcon section="type" />
<SchemaInfoIcon anchor="#type" />

<div id="form-content">
<p class="question">
What is the commit identifier of the work?
<SchemaInfoIcon section="commit" />
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
<SchemaInfoIcon section="commit" />
<SchemaInfoIcon anchor="#commit" />


<p class="question">
What is the version of the work?
<SchemaInfoIcon section="version" />
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
<SchemaInfoIcon section="version" />
<SchemaInfoIcon anchor="#version" />


<p class="question">
When was the version released?
<SchemaInfoIcon section="date-released" />
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
<SchemaInfoIcon section="date-released" />
<SchemaInfoIcon anchor="#date-released" />

Copy link
Copy Markdown
Member

@jspaaks jspaaks left a comment

Choose a reason for hiding this comment

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

Hi Abel, this is really nice thank you. I left some minor comments, what do you think? Also, how would you feel about changing the name of SchemaInfoIcon to SchemaGuideLink? For me that covers more of the role it has.

@abelsiqueira
Copy link
Copy Markdown
Collaborator Author

Thanks for the review. I agree with the suggestions and I updated the PR with them.

@abelsiqueira abelsiqueira requested a review from jspaaks May 11, 2022 07:33
@abelsiqueira abelsiqueira changed the title Create SchemaInfoIcon with an icon that points to the schema guide Create SchemaGuideLink with an icon that points to the schema guide May 11, 2022
Comment thread src/components/Preview.vue Outdated
</q-tooltip>
<q-tooltip
anchor="center left"
anchor="#center left"
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
anchor="#center left"
anchor="center left"

Copy link
Copy Markdown
Member

@jspaaks jspaaks left a comment

Choose a reason for hiding this comment

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

One minor suggestion to correct what seems like a find and replace error, otherwise good to go.

@abelsiqueira
Copy link
Copy Markdown
Collaborator Author

Nice catch. Thanks for the review

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