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

docs: add contributing pages #2869

Draft
wants to merge 11 commits into
base: next
Choose a base branch
from

Conversation

xDivisionByZerox
Copy link
Member

Already creating a WIP-PR to let people preview the new contributing page for the website.

I'm still working on pages which are empty, since I'm only commiting entire pages for now!
You should be able to give feedback on pages that contain text.

The goal is to fix #1513.

@xDivisionByZerox xDivisionByZerox added the c: docs Improvements or additions to documentation label May 1, 2024
@xDivisionByZerox xDivisionByZerox added this to the vAnytime milestone May 1, 2024
@xDivisionByZerox xDivisionByZerox self-assigned this May 1, 2024
@xDivisionByZerox xDivisionByZerox requested a review from a team as a code owner May 1, 2024 18:40
Copy link

netlify bot commented May 1, 2024

Deploy Preview for fakerjs ready!

Name Link
🔨 Latest commit b740f3c
🔍 Latest deploy log https://app.netlify.com/sites/fakerjs/deploys/6632c4a7d41bc0000887a195
😎 Deploy Preview https://deploy-preview-2869.fakerjs.dev
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

@xDivisionByZerox xDivisionByZerox marked this pull request as draft May 1, 2024 18:41
Copy link

codecov bot commented May 1, 2024

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 99.95%. Comparing base (36363cb) to head (b740f3c).

Additional details and impacted files
@@           Coverage Diff           @@
##             next    #2869   +/-   ##
=======================================
  Coverage   99.95%   99.95%           
=======================================
  Files        2975     2975           
  Lines      214451   214451           
  Branches      597      603    +6     
=======================================
+ Hits       214360   214364    +4     
+ Misses         91       87    -4     

see 1 file with indirect coverage changes

docs/.vitepress/config.ts Outdated Show resolved Hide resolved
docs/.vitepress/config.ts Outdated Show resolved Hide resolved
docs/.vitepress/config.ts Outdated Show resolved Hide resolved
docs/.vitepress/config.ts Outdated Show resolved Hide resolved
General criteria for new features are as follows:

- **Relevance**: Must be widely applicable and not specific to a particular niche.
- **Deterministic**: Functions must be based on Fakers internal [Randomizer](/api/randomizer).
Copy link
Member

Choose a reason for hiding this comment

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

Should we mention that transient usages of the Randomizer are allowed as well?

docs/contributing/propose-a-feature.md Outdated Show resolved Hide resolved

::: tip Note
Using thumb-up emotes ( :+1: ) on issues gives the faker team a general idea of the community interest in a feature.
If you see a feature request that you like, leave an up vote to increase interest.
Copy link
Member

Choose a reason for hiding this comment

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

Maybe mention comments to explain their requirements as well?

Copy link
Member Author

Choose a reason for hiding this comment

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

Maybe add an additional section next to New Locale Criteria? Something like New Method Criteria, where we request acceptance critera from the issuer?

docs/contributing/propose-a-feature.md Outdated Show resolved Hide resolved
docs/contributing/propose-a-feature.md Outdated Show resolved Hide resolved
If your feature isn't accepted into the library, you can still create it using Faker's Helper methods.
Our goal is to empower developers, not limit possibilities.

For more details on creating custom features, refer to our documentation on [Create Complex Objects](/guide/usage#create-complex-objects).
Copy link
Member

Choose a reason for hiding this comment

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

I'm not sure whether the Create Complex Objects page is the best page to refer to here, but I don't know any better either.

@ST-DDT ST-DDT added the p: 1-normal Nothing urgent label May 1, 2024
Co-authored-by: ST-DDT <ST-DDT@gmx.de>
@matthewmayer
Copy link
Contributor

Is the end goal that this replaces CONTRIBUTING.md and that becomes a stub pointing at the web version?

@Shinigami92
Copy link
Member

Is the end goal that this replaces CONTRIBUTING.md and that becomes a stub pointing at the web version?

I hope not 👀
IMO "contributing" is more a GitHub related thing, than a user facing documentation 🤔

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
c: docs Improvements or additions to documentation p: 1-normal Nothing urgent
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Improve contributing guide
4 participants