miyagawa/web-scraper — pull request #12 by DQNEO (2013-11-23 20:13:54+00:00)
Title: fix SYNPOSIS to work

Sample codes in SYNOPSIS don't work.

I think there are 2 problems in using Twtter.

### 1: http://twitter.com/ requires SSL connections.

The sample code fails when user has no SSL support.
`GET https://twitter.com/miyagawa failed:
501 Protocol scheme 'https' is not supported (LWP::Protocol::https not installed)`

In other words, the SYNOPSIS depends on LWP::Protocol::https ( also on Net::SSLeay)

### 2. HTML structures of Twitter often change.

The sample code does not work even if user has got LWP::Protocol::https installed, because HTML strucure of twitter has been changed.

In my opinion, sample codes should not use commercial services like Twtter (or eBay or Google or whatever),
because they often change HTML structures.

On the other hand, static pages hosted by non-profitable organizations,
especially RFC or Specifications,rarely changes.

For example : http://www.w3.org/TR/html401/

So I think the web page of specification of HTML would be better in this case.