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 Quick Guide for Writing Tests to Contributing Documentation #1151

Open
wants to merge 14 commits into
base: main
Choose a base branch
from

Conversation

yadavshubham01
Copy link

@yadavshubham01 yadavshubham01 commented Dec 6, 2024

This pull request adds a new section to the contributing-docs.md file, providing a quick guide for writing effective tests. It includes best practices for test structure, naming conventions, and details on creating tests with Cypress, both for components and end-to-end (E2E) scenarios. Additionally, it provides resources for further reading on test writing.

How This Solves the Issue:
The enhancement improves the contributing-docs.md documentation by adding clear, concise instructions for contributors on how to write and structure tests. This ensures that new contributors have a reliable reference for implementing tests alongside their contributions, promoting consistency and quality in test coverage. The addition of this guide helps maintain robust and maintainable tests across the project.

Issue Number:

@yadavshubham01 yadavshubham01 requested a review from a team as a code owner December 6, 2024 14:02
Copy link

@github-actions github-actions bot left a comment

Choose a reason for hiding this comment

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

Welcome to the JSON Schema Community. Thanks a lot for creating your first pull request!! 🎉🎉 We are so excited you are here! We hope this is only the first of many! For more details check out README.md file.

@yadavshubham01
Copy link
Author

yadavshubham01 commented Dec 6, 2024

hey @benjagm please review this PR

Copy link

github-actions bot commented Dec 6, 2024

built with Refined Cloudflare Pages Action

⚡ Cloudflare Pages Deployment

Name Status Preview Last Commit
website ✅ Ready (View Log) Visit Preview f3708ad

Copy link

codecov bot commented Dec 6, 2024

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 100.00%. Comparing base (aa7650d) to head (f3708ad).

Additional details and impacted files
@@            Coverage Diff            @@
##              main     #1151   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files           10        10           
  Lines          373       373           
  Branches        94        94           
=========================================
  Hits           373       373           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

@valeriahhdez valeriahhdez self-requested a review December 6, 2024 14:55
@kurtmckee
Copy link
Contributor

@yadavshubham01 I noticed that you repeatedly edited your "please review this PR" request to @-mention different people, including me in one edit.

  1. I've never contributed to this repo to the best of my knowledge. Your manual effort to ping me was unnecessary.

  2. I see from your GitHub activity that you consistently, and immediately, ping people on every PR you open on GitHub.

    Please stop doing this. As demonstrated here, it's error prone (you might ping people who have nothing to do with the repo), and is unnecessary because repo owners typically receive notifications about PRs opened.

Thanks for your work to contribute to open source! I wish you well.

@yadavshubham01
Copy link
Author

Apologies for the inconvenience, I will be more careful next time

Copy link
Member

@gregsdennis gregsdennis left a comment

Choose a reason for hiding this comment

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

Please hold on this while we discuss in the issue. cc: @valeriahhdez

@valeriahhdez
Copy link
Contributor

valeriahhdez commented Dec 10, 2024

Hello @yadavshubham01,

Thank you for your work on this PR. The triage team reviewed issue #1147 and found that the project's needs were not clearly described and incorrectly pointed to the CONTRIBUTING-docs.md file as the place to document test guidelines.

Here are the key points from the triage team's review:

If you still want to work on issue #1147 we kindly ask you to commit your changes to the CONTRIBUTING.md guide. We apologize for any inconvenience caused. The maintainer's team had not yet triaged the issue when you opened the PR.

To prevent similar situations in the future, we are adding a new rule to our CONTRIBUTING.md guide: contributors should wait until a project maintainer assigns them to an issue before starting work on the changes.

Thank you for your understanding and have a nice day.

@yadavshubham01
Copy link
Author

hey @valeriahhdez i will make change in CONTRIBUTING.md

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.

[📝 Docs]: Add guidelines for writing tests for website components to the contributing guide
4 participants