[DOCS-12556] Deprecation status of GridFS options contentType and aliases Created: 20/Mar/19  Updated: 30/Oct/23  Resolved: 27/Mar/19

Status: Closed
Project: Documentation
Component/s: manual
Affects Version/s: None
Fix Version/s: Server_Docs_20231030

Type: Feedback Priority: Major - P3
Reporter: Daniel Aprahamian (Inactive) Assignee: Ravind Kumar (Inactive)
Resolution: Done Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Participants:
Days since reply: 4 years, 46 weeks ago
Story Points: 0.1

 Description   

Description

See:
https://mongo-db.slack.com/archives/C0KT5MWSH/p1553100673685800
https://mongo-db.slack.com/archives/C0KT5MWSH/p1553100695686400

From the driver perspective, the contentType and alias fields have been deprecated since 2015 in favor of the metadata field (GridFS Spec). These fields are not mentioned as deprecated in the docs for GridFS. Is there another mechanism for using contentType or aliases that has not deprecated these fields (like the shell or mongofiles)? If not, can we change the documentation to mark these fields as deprecated?

Thanks,
Dan

Scope of changes

  • mark contentType and aliases as deprecated
  • Advise users to use metadata for storing that information
  • mark md5 as deprecated
  • Advise users to create their own file digest/hash and add it to metadata

Impact to Other Docs

MVP (Work and Date)

Resources (Scope or Design Docs, Invision, etc.)



 Comments   
Comment by Githook User [ 27/Mar/19 ]

Author:

{'email': 'ravind.kumar@mongodb.com', 'name': 'rk-mongo'}

Message: Multiple small fixups:

DOCSP-4943: $cond requires all arguments
DOCS-12556: Deprecate GridFS contentType, aliases, MD5
DOCS-12543: query $and accepts one expression
DOCSP-4791: Certain background operations can block setFeatureCompatibilityVersion
Branch: v3.4
https://github.com/mongodb/docs/commit/1216a876af0bcdecd370707ed551d08846958023

Comment by Githook User [ 27/Mar/19 ]

Author:

{'email': 'ravind.kumar@mongodb.com', 'name': 'rk-mongo'}

Message: Multiple small fixups:

DOCS-12567: Removing duplicate line
DOCSP-4943: $cond requires all arguments
DOCS-12556: Deprecate GridFS contentType, aliases, MD5
DOCS-12543: query $and accepts one expression
DOCSP-4791: Certain background operations can block setFeatureCompatibilityVersion
Branch: v4.0
https://github.com/mongodb/docs/commit/90f65234bfd1a090fba330240c8d06d3d0b83b82

Comment by Githook User [ 27/Mar/19 ]

Author:

{'name': 'rk-mongo', 'email': 'ravind.kumar@mongodb.com'}

Message: Multiple small fixups:

DOCSP-4943: $cond requires all arguments
DOCS-12556: Deprecate GridFS contentType, aliases, MD5
DOCS-12543: query $and accepts one expression
DOCSP-4791: Certain background operations can block setFeatureCompatibilityVersion
Branch: v3.6
https://github.com/mongodb/docs/commit/33fec46eb47f75515d0dcf3d08746cbb35825912

Comment by Githook User [ 27/Mar/19 ]

Author:

{'name': 'rk-mongo', 'email': 'ravind.kumar@mongodb.com'}

Message: Multiple small fixups:

DOCS-12567: Removing duplicate line
DOCSP-4943: $cond requires all arguments
DOCS-12556: Deprecate GridFS contentType, aliases, MD5
DOCS-12543: query $and accepts one expression
DOCSP-4791: Certain background operations can block setFeatureCompatibilityVersion
Branch: master
https://github.com/mongodb/docs/commit/0da16c78a71ab3db1a30b9f7087b2c09bf01db44

Comment by David Golden [ 20/Mar/19 ]

I think we should remove them from the 4.2 documentation for sure.  I'm on the fence about 4.0 since we never marked them deprecated and people might not think to look back to 3.4/3.6.

Generated at Thu Feb 08 08:05:32 UTC 2024 using Jira 9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66.