Improve dump FAQ

[noahfalk]

Fixes dotnet/diagnostics#4375

• The previous guidance for diagnosing dump permission issues did not mention the interaction between setcap and ptrace. I added that information as well as a more complete description of the ptrace access checking.

• There was no link to the FAQ in the TOC so I added one.

• I made some minor edits to the dump overview page that IMO improved clarity and flow of the text.

---

Internal previews

📄 File	🔗 Preview link
docs/core/diagnostics/dumps.md	Dumps
docs/core/diagnostics/faq-dumps.yml	FAQ for dumps
docs/navigate/tools-diagnostics/toc.yml	docs/navigate/tools-diagnostics/toc

[noahfalk]

@hoyosjs - could you take a look?

[gewarren]

@noahfalk - A couple of preliminary comments:

1. It looks like the FAQ was removed from the TOC in this PR: https://github.com/dotnet/docs/pull/35727/files#diff-b145b47b58321afe32381e792b9078f298017444a9ec9823d775e1324c28c6e0
2. The Learn platform guide wants us to create FAQ docs as YAML files for search result optimization (see [the internal only doc] https://review.learn.microsoft.com/en-us/help/patterns/level4/article-structured-faq?branch=main#what-is-this-pattern)

[noahfalk]

The Learn platform guide wants us to create FAQ docs as YAML files

OK, when I change it back to YAML should I strip the links out of the questions? Previously those links weren't rendering properly.

It looks like the FAQ was removed from the TOC in this PR

Do you think I should leave it out of the TOC? I was under the impression that all content was recommended to be in the TOC.

[gewarren]

OK, when I change it back to YAML should I strip the links out of the questions? Previously those links weren't rendering properly.

Yes, I don't think you can have links in the questions.

Do you think I should leave it out of the TOC? I was under the impression that all content was recommended to be in the TOC.

No, it should absolutely be in the TOC. I'm just pointing out that it was probably accidentally dropped during that reorganization of the TOC.

[hoyosjs]

Discussed feedback offline.

[hoyosjs]

Part of me feels that YML FAQ optimization is nice, but the links are essential to this particular doc. Is there a strong opinion on it having to be yml?

[noahfalk]

Part of me feels that YML FAQ optimization is nice, but the links are essential to this particular doc. Is there a strong opinion on it having to be yml?

We don't need to remove all the links, just I think two of them that show up in the question text itself.

[gewarren]

Part of me feels that YML FAQ optimization is nice, but the links are essential to this particular doc. Is there a strong opinion on it having to be yml?

Could you do something like this, basically move the links to the answer?

  - question: |
      Why do I only get dumps on Linux if dotnet-dump or my crashing process is running elevated?
    answer: | 
      On Linux-based systems, you only get dumps if [dotnet-dump](dotnet-dump.md) or the [crashing process](dumps.md#collect-dumps-on-crash) runs elevated because `/proc/sys/kernel/ptrace_scope` controls who can call `ptrace` and what processes they can trace. We recommend setting it to `1` - meaning only processes in the same ancestry chain can use traced. Any value higher than this requires elevation or might disable `ptrace` altogether.  

[noahfalk]

I updated the PR back to yml and removed the links from the question. I didn't wind up adding the links to the answer either because in the revised text the links didn't fit as naturally. I don't think those two particular links were high importance.

[noahfalk]

Thanks @gewarren and @hoyosjs for the review and feedback!