Opened 7 years ago

Closed 7 years ago

Last modified 4 years ago

#8848 closed Uncategorized (fixed)

[Custom file storage] Contradiction between code and docs

Reported by: Piotr Lewandowski <django@…> Owned by: nobody
Component: Documentation Version: master
Severity: Normal Keywords: file storage comment
Cc: Triage Stage: Unreviewed
Has patch: no Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: no UI/UX:

Description

http://code.djangoproject.com/browser/django/trunk/django/core/files/storage.py#L83:

    # The following methods form the public API for storage systems, but with
    # no default implementations. Subclasses must implement *all* of these.

Meanwhile, in http://docs.djangoproject.com/en/dev/howto/custom-file-storage/#howto-custom-file-storage:

Your custom storage system may override any of the storage methods explained in File storage API.

Change History (5)

comment:1 Changed 7 years ago by Piotr Lewandowski <django@…>

  • Cc ubanus@… added
  • Needs documentation unset
  • Needs tests unset
  • Patch needs improvement unset

comment:2 Changed 7 years ago by Piotr Lewandowski <django@…>

  • Summary changed from [Custom file storage] Contradiction in code and docs to [Custom file storage] Contradiction between code and docs

comment:3 Changed 7 years ago by jacob

  • Resolution set to fixed
  • Status changed from new to closed

(In [8942]) Fixed #8848: clarified custom file storage backend docs in light of the more clear code comments.

comment:4 Changed 4 years ago by ubanus@…

  • Cc ubanus@… removed
  • Easy pickings unset
  • Severity set to Normal
  • Type set to Uncategorized

comment:5 Changed 4 years ago by jacob

  • milestone 1.0 deleted

Milestone 1.0 deleted

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