Skip to content

Latest commit

 

History

History
59 lines (32 loc) · 3.98 KB

CONTRIBUTING.md

File metadata and controls

59 lines (32 loc) · 3.98 KB

Contributing an Instant Answer to DuckDuckGo.com

Learn to Make New Instant Answers

Learn to make an Instant Answer by starting with our walkthroughs:

UPDATE: We're aiming to have multiple Instant Answers for every programming language and framework. Jump in and help us fill in the blanks.

You can find the full DuckDuckHack documentation here.

Improve a Live Instant Answer

We welcome new contributors to dive in and improve live Instant Answers. It's a great, hands-on way to learn how things work:

Go Live on DuckDuckGo.com

The final step is to have your contribution appear on DuckDuckGo.com above ads and organic links, on millions of searches.

  1. Create an Instant Answer Page as the home base for your idea. If you're fixing an existing Instant Answer, locate its existing page.

    This page will be the center for feedback, Github issues, attribution, deployment, and collaboration.

  2. Make sure your contribution meets the Production Guidelines.

  3. Submit a pull request.

We're excited to meet you and support you along the way - and it's never too early to say hello. Join us on Slack or email.

Formatting Your Pull Request

When submitting a pull request, the following guidelines help speed up the review process:

New Instant Answers

  1. New IAs should be titled as follows: New {IA TOPIC} {IA TYPE}. For example, New Instagram Spice or New Firefox Cheat Sheet

  2. Paste the relevant Instant Answer Page URL in the description field. This will automatically link the PR to the Instant Answer.

Improvements

  1. Fixes should be titled as follows: {IA NAME}: Brief explanation. For example: PeopleInSpace: Use smaller local image, fallback to API when needed.

  2. Paste the relevant Instant Answer Page URL in the description field. This will automatically link the PR to the Instant Answer.

  3. Include the issue number in the description (conveniently, this will automatically resolve the issue upon merging). Describe your motivation, thought process, and solution in the description. For example:

    "Fixes #2038. The images used by the API are very large and don't change often. I've but a smaller version of each image (and a 2x version for retina screens) in the share directory. The callback will try and load a local image based on the astronauts name and fallback to using the API's image if one does not exist."

IMPORTANT: Don't worry if you get an initial error regarding failing Travis tests. The reason is that your IA page hasn't yet been moved out of the "Planning" status - which only community leaders/staff can do. As long as the ID in your IA page matches the ID in your code, and you've pasted the URL to your IA page, you can ignore this initial error.