Uploaded image for project: 'C# Driver'
  1. C# Driver
  2. CSHARP-5040

InsertMany summary comments are wrong and missing important information

    • Type: Icon: Bug Bug
    • Resolution: Gone away
    • Priority: Icon: Unknown Unknown
    • None
    • Affects Version/s: None
    • Component/s: None
    • Labels:
      None
    • C Drivers

      Summary

      Important InsertMany information is wrong and missing from the code comments above their signatures

      The summary comments above the InsertMany signatures of the IMongoCollection interface are incorrect in that they say they will return a result. These are void and Task functions and do not return a result.

      Additionally it would be useful for the comment to state whether IDs will be set on the inserted items if successful or not. It appears IDs are only set if a {{ICollection }}object is passed in opposed to an {{IEnumerable }}which should absolutely be documented because this behavior is not obvious at all and left me scratching my head until I found the information on StackOverflow

            Assignee:
            robert@mongodb.com Robert Stam
            Reporter:
            ben@gdsestimating.com Ben Zuill-Smith
            Votes:
            0 Vote for this issue
            Watchers:
            4 Start watching this issue

              Created:
              Updated:
              Resolved: