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

Feature/alertbox #218

Merged
merged 7 commits into from
Jun 22, 2020
Merged

Feature/alertbox #218

merged 7 commits into from
Jun 22, 2020

Conversation

jlealess
Copy link
Contributor

  • creates a new alertbox component to encourage users to contribute
  • adds alertbox component to definition page template to ask users improve existing definitions

@jlealess
Copy link
Contributor Author

@tatianamac I just saw your message about my previous PR being closed when you renamed your branch; this replaces the old one.

Copy link
Contributor

@sarenji sarenji left a comment

Choose a reason for hiding this comment

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

This looks great to me!

I also noticed the PR also contains a change to package-lock.json. I checked out your branch, did an npm install, and the optionals got added back. I've seen this happen in the past when the developer's local node version doesn't match the project's. In this case, selfdefined seems to use node version 12.

(In case anyone is unaware, nvm can manage your node versions, which gets enforced by the project's .nvmrc file.)

@@ -0,0 +1,4 @@
<div class="alertbox">
<h2 class="alertbox__title">Something not quite right?</h2>
<p class="alertbox__content">If you found a typo, would like to add another resource, or add nuance to this definition, please feel free to submit <a href="https://github.com/tatianamac/selfdefined/issues" rel="noreferral">an issue</a> or <a href="https://github.com/tatianamac/selfdefined/pulls" rel="noreferral">pull request</a>.</p>
Copy link
Contributor

Choose a reason for hiding this comment

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

noreferral may not be a valid rel value; maybe it's meant to be noreferrer or nothing?

I also had this thought, but feel free to ignore: Since the links' intent are for actions the user could take, what do you think of adding a verb to each link? This might be helpful when visually scanning content, or for generating a list of links (e.g. in a web rotor), as it's clearer what the link is for. In this case, this would read, "... feel free to [submit an issue] or [submit a pull request]".

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Hey @sarenji , these are great suggestions!

Good catch on noreferral. I copied the links from the ones already in /selfdefined/11ty/index.njk without thinking about the syntax. I don't have any background on why noreferral would have been used as the rel value for those links but operating under the assumption that there's a reason that file's author put it there and that they actually wanted noreferrer, I've updated the syntax there as well as in my file.

I've taken your suggestion about including the action verbs in the links as well; it reads and scans better. Thanks!

Copy link
Collaborator

Choose a reason for hiding this comment

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

The author was me and the reason was «not really thinking». Thanks for fixing it. If you like, feel free to add them to other external links, too. If not, no worries, I’ll open a separate PR :)

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Hey @olvb , thanks for the context!

I don't mind making that update but I'm thinking it might be good to address updating other external links in a separate PR so that we can get this callout into prod after being in the works for a few weeks and keep this PR lean.

If I were to submit a separate PR for that, should all external links have rel=noreferrer applied to them?

Copy link
Collaborator

Choose a reason for hiding this comment

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

Agreed with not cluttering this PR. I’ve created #236 to have a dedicated space for this discussion and to agree on an outcome which we can implement.

Copy link
Collaborator

Choose a reason for hiding this comment

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

(Oh, btw, my username is ovlb, olvb is someone totally unrelated, but I think by now they have muted this repo, because this typo happens so often.)

@tatianamac
Copy link
Collaborator

Thank you for reviewing, @sarenji ! 🙏🏽

@tatianamac
Copy link
Collaborator

@jlealess Hi! Do you feel as though you're able to address these suggestions from @sarenji ?

@jlealess
Copy link
Contributor Author

@tatianamac Yes, I've implemented @sarenji 's excellent suggestions and updated my branch; it's ready for review again.

Copy link
Collaborator

@tatianamac tatianamac left a comment

Choose a reason for hiding this comment

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

🚀 Looks perfect!

@tatianamac tatianamac merged commit 5789b39 into selfdefined:prod Jun 22, 2020
@tatianamac
Copy link
Collaborator

@jlealess Awesome! I have merged this in! Would you be okay with thanking you for contributing this when we share it on Twitter?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants