Opened 8 years ago

Closed 8 years ago

Last modified 5 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 8 years ago by Piotr Lewandowski <django@…>

Cc: ubanus@… added

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

Summary: [Custom file storage] Contradiction in code and docs[Custom file storage] Contradiction between code and docs

comment:3 Changed 8 years ago by Jacob

Resolution: fixed
Status: newclosed

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

comment:4 Changed 6 years ago by ubanus@…

Cc: ubanus@… removed
Easy pickings: unset
Severity: Normal
Type: Uncategorized

comment:5 Changed 5 years ago by Jacob

milestone: 1.0

Milestone 1.0 deleted

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