Ticket #11462 (closed enhancement: fixed)

Opened 2 years ago

Last modified 16 months ago

Improve @parallel documentation to give examples of functions with multiple arguments

Reported by: niles Owned by: mvngu
Priority: major Milestone: sage-5.0
Component: documentation Keywords: @parallel documentation beginner sd35.5
Cc: kcrisman Work issues:
Report Upstream: N/A Reviewers: Karl-Dieter Crisman
Authors: Nathan Carter Merged in: sage-5.0.beta1
Dependencies: Stopgaps:

Description

All of the examples for @parallel (even those mentioned on mailing lists) demonstrate using it with functions that take a single argument. Figuring out the syntax for multiple-argument functions can be slightly non-obvious, so the documentation should be improved.

More details at this  asksage question.

Attachments

trac-11462-parallel-documentation.patch Download (1.4 KB) - added by ncarter 16 months ago.

Change History

comment:1 Changed 2 years ago by niles

  • Type changed from PLEASE CHANGE to defect

comment:2 Changed 16 months ago by ncarter

  • Status changed from new to needs_review

Will post in a moment a patch that does what this ticket asks...

comment:3 Changed 16 months ago by ncarter

  • Keywords sd35.5 added

Changed 16 months ago by ncarter

comment:4 Changed 16 months ago by ncarter

Updated patch to ensure doctests succeed.

comment:5 Changed 16 months ago by kcrisman

  • Status changed from needs_review to positive_review
  • Reviewers set to Karl-Dieter Crisman
  • Authors set to Nathan Carter

Good work, looks good in the manual, all is correct and passes tests. Positive review.

comment:6 Changed 16 months ago by jdemeyer

  • Type changed from defect to enhancement
  • Work issues improve documentation deleted
  • Milestone changed from sage-4.8 to sage-5.0

comment:7 Changed 16 months ago by kcrisman

See also #11461.

comment:8 Changed 16 months ago by jdemeyer

  • Status changed from positive_review to closed
  • Resolution set to fixed
  • Merged in set to sage-5.0.beta1
Note: See TracTickets for help on using tickets.