Opened 7 years ago

Last modified 6 years ago

#18306 new enhancement

"comparison" thematic tutorial

Reported by: jdemeyer Owned by:
Priority: major Milestone: sage-6.7
Component: documentation Keywords:
Cc: vdelecroix, jpflori Merged in:
Authors: Jeroen Demeyer Reviewers:
Report Upstream: N/A Work issues:
Branch: u/jdemeyer/ticket/18306 (Commits, GitHub, GitLab) Commit: 1a6697af9cbe30930b44493d05b02497f28dce71
Dependencies: #17890 Stopgaps:

Status badges

Description

Python has very little documentation about how comparisons work (both __cmp__, __richcmp__ in Cython and __eq__, __lt__, ... in Python). When you throw in the Sage coercion framework, it gets only worse.

All this deserves a new thematic tutorial.

Change History (9)

comment:1 Changed 7 years ago by jdemeyer

  • Authors set to Jeroen Demeyer
  • Dependencies set to #17890

comment:2 Changed 7 years ago by vdelecroix

  • Cc vdelecroix added

comment:3 Changed 7 years ago by jdemeyer

  • Branch set to u/jdemeyer/ticket/18306

comment:4 Changed 7 years ago by kcrisman

  • Commit set to 7de538eac1c099b6b6790ab3db556128d020be81

Nice start - if I finally understand this based on the finished product, I'll give it a positive review!

(One could also open a sage-wishlist ticket for expanding this to Python 3 as part of the Python 3 meta-ticket?)


New commits:

7de538eAdd "comparison" tutorial

comment:5 Changed 6 years ago by jpflori

  • Cc jpflori added

comment:6 Changed 6 years ago by git

  • Commit changed from 7de538eac1c099b6b6790ab3db556128d020be81 to 3ada14b44fa7f20779913decfa5101c9bcf00cf2

Branch pushed to git repo; I updated commit sha1. This was a forced push. New commits:

3ada14bAdd "comparison" tutorial

comment:7 follow-up: Changed 6 years ago by mmezzarobba

Just a small suggestion: link to the tutorial from the developer guide—or perhaps make it a chapter of the developer guide rather than a thematic tutorial?

comment:8 Changed 6 years ago by git

  • Commit changed from 3ada14b44fa7f20779913decfa5101c9bcf00cf2 to 1a6697af9cbe30930b44493d05b02497f28dce71

Branch pushed to git repo; I updated commit sha1. This was a forced push. New commits:

1a6697aAdd "comparison" tutorial

comment:9 in reply to: ↑ 7 Changed 6 years ago by jdemeyer

Replying to mmezzarobba:

Just a small suggestion: link to the tutorial from the developer guide

That's not currently technically possible.

or perhaps make it a chapter of the developer guide rather than a thematic tutorial?

Personally, I don't think it fits within the scope of the developer's guide. There are several other thematic tutorials which explain one specific aspect of Python/Cython/Sage? programming, it fits more with those.

Note: See TracTickets for help on using tickets.