duckduckgo-documentation

duckduckgo-documentation copied to clipboard

Fathead: Add links to scrapers / resources for people who are new to scraping

1

Things like http://scrapy.org/

jagtalon

Remove "Stack Overflow" as an example?

1

In the second paragraph, Stack Overflow is linked as an API-based forum lookup. Might be a bit misleading because DDG crawls SO instead of calling an API.

jagtalon

I was reading the template section in http://docs.duckduckhack.com/walkthroughs/forum-lookup.html, and it might be beneficial to link to http://handlebarsjs.com/ just in case a developer is not familiar with it and wants to...

jagtalon

Docs Simplification

10

talsraviv

Clearer docs overall (from examples to tone)

3

talsraviv

Goodies: Clarify that even seemingly small files that can be slurped can be bad

2

If we receive a goodie that reads a file, be sure to check if the files will be expanded (say, a list of electronic parts) or if they are a...

jagtalon

Testing pages (https://duck.co/duckduckhack/test_files) is too vague

2

Hey, IMO, the testing page could do with explaining that the text, html and heading outputs need to be tested as a whole. Currently this isn't obvious and I can't...

mintsoft

Common paradigms and patterns should be encouraged more!

3

We're starting to build up a couple of nice work patterns around Goodies and Spices wrt to the "best way" to handle things; for example the `NumberStyler` and `Dates` role...

mintsoft

Maybe it's better to generalize this as Perl because it's possible that people might think that it's okay to make network requests in the Perl side of Spice IAs. ![screen...

jagtalon

I think it's worth documenting how we process the `output.txt` behind the scenes. For example, it's hard to tell if: - Do the keys need to be lowercased? - Do...

jagtalon