You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
sherlock/CONTRIBUTING.md

1.5 KiB

How To Contribute To Sherlock

First off, thank you for the help!

There are many ways to contribute. Here is some high level grouping.

Adding New Sites

Please look at the Wiki entry on adding new sites to understand the issues.

Any new sites that are added need to have a username that has been claimed, and one that is unclaimed documented in the site data. This allows the regression tests to ensure that everything is working.

It is required that a contributer test any new sites by either running the full tests, or running a site-specific query against the claimed and unclaimed usernames.

It is not required that a contributer run the site_list.py script.

If there are performance problems with a site (e.g. slow to repond, unrealiable uptime, ...), then the site may be removed from the list.

In regards to adult sites (e.g. PornHub), we have agreed to not include them in Sherlock.
However, we do understand that some users desires this support. The data.json file is easy to add to, so users will be able to maintain their own forks to have this support. This is not ideal.
Maybe there could be another repo with an adult data.json? That would avoid forks getting out of date.

Adding New Functionality

Please ensure that the content on your branch passes all tests before submitting a pull request.