> Can you give me an example of how you would frame the material in your response using task-based documentation?
My response is task based. The titles are tasks you would like to perform.
Compare with the TOC of the NLTK book:
'Accessing Text Corpora and Lexical Resources (extras)'
What is this? What does it help me do?
If it's prepare a document for analysis, then the title should be 'Preparing text for analysis'
'3. Processing Raw Text'
'Process' is a meaningless word, like 'System' or 'Data'
4. Writing Structured Programs (extras)
That sounds like a coding guidelines document. What does it have to do with language? Why do I want to do this?
7. Extracting Information from Text
Better.
8. Analyzing Sentence Structure (extras)
9. Building Feature Based Grammars
Why do I want to do that?
10. Analyzing the Meaning of Sentences (extras)
Good. Better would be 'Determining the meaning of sentences'
11. Managing Linguistic Data
'Managing' is another meaningless word. Are you going to process a managed data system now? No? Perhaps there's some practical advice regarding handling large volumes of text here. Cool, then my task, and the title, should be 'Handing large volumes of text'.
My response is task based. The titles are tasks you would like to perform.
Compare with the TOC of the NLTK book:
'Accessing Text Corpora and Lexical Resources (extras)'
What is this? What does it help me do?
If it's prepare a document for analysis, then the title should be 'Preparing text for analysis'
'3. Processing Raw Text'
'Process' is a meaningless word, like 'System' or 'Data'
4. Writing Structured Programs (extras)
That sounds like a coding guidelines document. What does it have to do with language? Why do I want to do this?
7. Extracting Information from Text
Better.
8. Analyzing Sentence Structure (extras) 9. Building Feature Based Grammars
Why do I want to do that?
10. Analyzing the Meaning of Sentences (extras)
Good. Better would be 'Determining the meaning of sentences'
11. Managing Linguistic Data
'Managing' is another meaningless word. Are you going to process a managed data system now? No? Perhaps there's some practical advice regarding handling large volumes of text here. Cool, then my task, and the title, should be 'Handing large volumes of text'.