more documentation

[jamesturk]

• advanced sources
• custom page types
• custom selectors
• multiple items in a chain
• use as a library vs. workflow
• page dependencies
• page chaining
• logging
• pagination
• contributing
• SkipItem
• details on selectors / how to scrape
• --dump and --output-dir examples

[jefftriplett]

The "use as a library vs. workflow" would be really nice to help promote it. I read through the docs and it wasn't obvious to me if I should write imported based on the files that spatula outputs, or how to get my arms around how to have it save a Django model or even call a function once done.

[jamesturk]

thanks for this feedback! I was actually just working to add this:

https://github.com/jamesturk/spatula/blob/main/docs/scraper-basics.md#using-spatula-within-other-scripts

as I realized it had fallen off my radar before the 0.8 release-- the do_scrape convenience method will be there with 0.8.1 which will be out very soon (possibly today)

[jefftriplett]

This is great. I'll check it out this afternoon.

In case someone else stumbles on this, https://devhints.io/xpath took the edge off for those of us who don't use xpath as often.

[jamesturk]

thanks for that link! I'm planning to add some basic XPath/CSS tips and/or links to better resources and this looks strong