dotnet / dotnet/dotnet-api-docs
Document behaviour of ConcurrentDictionary AddOrUpdate when factory funcs throw
- Dominant language
- C#
- Stars
- 949
- Forks
- 1.7k
- Avg merge
- 3d 27m
- Merged PRs (30d)
- 49
Description
### Type of issue
Missing information
### Description
The ConcurrentDictionary AddOrUpdate() docs don't explain what happens if the factory funcs throw. The implementation appears to abort the action and leave the dictionary unchagned. Is this behaviour guaranteed?
### Page URL
https://learn.microsoft.com/en-us/dotnet/api/system.collections.concurrent.concurrentdictionary-2.addorupdate?view=net-10.0
### Content source URL
https://github.com/dotnet/dotnet-api-docs-temp/blob/live/xml/System.Collections.Concurrent/ConcurrentDictionary`2.xml
### Document Version Independent Id
125a4bf6-81d6-6239-c403-274b4ced126f
### Platform Id
5191d709-dd5b-3d43-cae2-6d630ddcf75e
### Article author
@dotnet-bot
Contributor guide
Research direction
Open the linked ConcurrentDictionary`2.xml source and locate the AddOrUpdate() documentation entry. Read the existing API wording, then verify the documented behavior for exceptions from both factory functions against the current implementation or API contract. Done means the page clearly states what happens to the operation and dictionary when a factory throws.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- csharp
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 72/100