Opened 5 years ago

Closed 5 years ago

Last modified 18 months ago

#12922 closed Uncategorized (wontfix)

BaseInlineFormset.save_new() undocumented

Reported by: anonymous Owned by: nobody
Component: Uncategorized Version: 1.2-beta
Severity: Normal Keywords:
Cc: Triage Stage: Unreviewed
Has patch: no Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: no UI/UX: no

Description

BaseInlineFormset.save_new is not documented in code or in the documentation. It's pretty easy to figure out what it does in code, but there is no mention of it anywhere else.

Change History (3)

comment:1 Changed 5 years ago by russellm

  • Needs documentation unset
  • Needs tests unset
  • Patch needs improvement unset
  • Resolution set to wontfix
  • Status changed from new to closed

There's a reason for it not being documented - once we document something, we commit to not changing the interface. I can't think of any particularly compelling reason that save_new should be part of documented API.

comment:2 Changed 18 months ago by d.tchen@…

  • Easy pickings unset
  • Severity set to Normal
  • Type set to Uncategorized
  • UI/UX unset

Do you guys happen to mention that on some kind of "READ THIS BEFORE LEARNING" or something type page? So much of my avoidance in using stuff like this is because I would think editing it would break something and be hard to work with...

comment:3 Changed 18 months ago by timo

We do have an API stability policy.

Note: See TracTickets for help on using tickets.
Back to Top