Ticket #1034 (closed proposal: fixed)

Opened 6 years ago

Last modified 4 years ago

Added examples, more detailed documentation to Data.List functions of "Extracting sublists" section

Reported by: guest Owned by:
Priority: normal Milestone:
Component: libraries/base Version: 6.6
Keywords: Cc:
Operating System: Unknown/Multiple Architecture: Unknown/Multiple
Type of failure: Difficulty: Easy (less than 1 hour)
Test Case: Blocked By:
Blocking: Related Tickets:

Description

Goal of my changes it to make list functions more accessible to Haskell newcomers. "Extracting sublists" section seems to have less complete documentation than rest of the module.

Added examples for all the functions. Added easier to understand summaries for composite functions.

Attachments

listDocs.diff Download (45.1 KB) - added by Andriy 6 years ago.
New version of the patch - added examples for corner cases.
listDocs.html Download (5.6 KB) - added by Andriy 6 years ago.
HTML file showing Haddock results for the affected part of documentation.

Change History

Changed 6 years ago by guest

Proposal deadline: Wednesday, December 6th.

Andriy

Changed 6 years ago by Andriy

New version of the patch - added examples for corner cases.

Changed 6 years ago by Andriy

HTML file showing Haddock results for the affected part of documentation.

Changed 6 years ago by Andriy

No dissent. Supported by Donald Bruce Stewart, Neil Mitchell, Ross Paterson.

Neil Mitchell suggested to include corner cases which I did in the second version of the patch (attached). He later suggested to add QuickCheck? style properties. I decided to leave this out of scope for this proposal.

Changed 6 years ago by igloo

  • status changed from new to closed
  • resolution set to fixed

Patch applied to HEAD and 6.6 branches.

Changed 5 years ago by simonmar

  • architecture changed from Unknown to Unknown/Multiple

Changed 5 years ago by simonmar

  • os changed from Multiple to Unknown/Multiple

Changed 4 years ago by simonmar

  • difficulty changed from Easy (1 hr) to Easy (less than 1 hour)
Note: See TracTickets for help on using tickets.