Subject: | Suggestions for simple documentation improvements |
Hi.
I went looking for a module to do what your does but it took me a long time to find yours, and when I did I wasn't sure from the documentation that it fitted my needs. It turns out to be far more powerful than the documentation DateTime::Format::Natural suggests.
So I've two simple suggestions for you:
* The abstract "Create machine readable date/time with natural parsing logic" could be more useful. Phrases like 'machine readable' and words like 'logic' don't add much value. I suggest "Create and parse informal natural language date/time strings".
* The docs for DateTime::Format::Natural don't have examples of informal natural language date/time strings that it can parse. I suggest adding some examples of it parsing absolute, relative and durations from informal natural language strings.