Dotnet-api-docs: No content

[ericrrichards]

So, where is the documentation? I guess we're still at auto-generated stubs, without any of the old doc moved over.
This is the top Google search result, so at least the SEO is working.

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: 81498c77-e953-d79b-d758-09e63edc61fd
• Version Independent ID: 51907d96-b483-143d-0462-45d3b3cd2b30
• Content: Dictionary<TKey,TValue>.TryAdd(TKey, TValue) Method (System.Collections.Generic)
• Content Source: [xml/System.Collections.Generic/Dictionary2.xml](https://github.com/dotnet/dotnet-api-docs/blob/master/xml/System.Collections.Generic/Dictionary2.xml)
• Product: dotnet-api
• GitHub Login: @dotnet-bot
• Microsoft Alias: dotnetcontent

[pkulikov]

@ericrrichards

...without any of the old doc moved over

There are no old docs for this method, as this method is new and present only in .NET Core 2.0 and later.

Thank you for pointing out the missing content.

The TryAdd method behaves as the Add method in case the element with the given key doesn't exist in the dictionary: it inserts the entry to the dictionary and returns true. Unlike the Add method, TryAdd doesn't throw an exception if the element with the given key exists in the dictionary. Unlike the dictionary indexer, TryAdd doesn't override the element if the element with the given key exists in the dictionary. Instead, TryAdd does nothing and returns false.

[ericrrichards]

Okay, lovely. I was trying to figure out if this operated with the same
behavior as one has come to expect from .NET collection TryAdd methods

On Mon, Oct 1, 2018 at 12:05 PM, Petr Kulikov [e-mail]
wrote:

@ericrrichards https://github.com/ericrrichards

...without any of the old doc moved over

There are no old docs for this method, as this method is new and present
only in .NET Core 2.0 and later.

Thank you for pointing out the missing content.

The TryAdd method behaves as the Add method
https://docs.microsoft.com/en-us/dotnet/api/system.collections.generic.dictionary-2.add?view=netcore-2.1
in case the element with the given key doesn't exist in the dictionary: it
inserts the entry to the dictionary and returns true. Unlike the Add
method, TryAdd doesn't throw an exception if the element with the given
key exists in the dictionary. Unlike the dictionary indexer
https://docs.microsoft.com/en-us/dotnet/api/system.collections.generic.dictionary-2.item?view=netcore-2.1,
TryAdd doesn't override the element if the element with the given key
exists in the dictionary. Instead, TryAdd does nothing and returns false.

—
You are receiving this because you were mentioned.
Reply to this email directly, view it on GitHub
https://github.com/dotnet/docs/issues/7966#issuecomment-425964131, or mute
the thread
https://github.com/notifications/unsubscribe-auth/ACqJTUJ8fvhQJnHFPf7zDEdOvXU_8v0eks5ugj1DgaJpZM4XCWcV
.

[mairaw]

It seems that this API has a high number of visits. So adding docs for it should be prioritized. I'll try to add some this week.

[mairaw]

I've started working on this but haven't finished. I'll have to address this when I get back.

[SvenJedeck]

???

[mairaw]

Sorry this hasn't been done yet but I'm working on several releases on the past couple of weeks. I'll get this added as soon as possible.

[mairaw]

Moving to the backlog until I can actually pick this up to start working on it. But I've marked this as P1 and it's still assigned to me.

[SeanKilleen]

I took first pass at this over on #2260. This seemed like a high priority so figured I'd try to help out.

[mairaw]

Really appreciated @SeanKilleen! ❤️ I'm reviewing your PR right now.