dotnet / dotnet/dotnet-api-docs

Missing Regex Class Orientation Material

Open
#11,614 3 comments 0 reactions 0 assignees View on GitHub
:watch: Not Triaged area-System.Text.RegularExpressions untriaged
Dominant language
C#
Stars
949
Forks
1.7k
Avg merge
3d 27m
Merged PRs (30d)
49

Description

_This issue has been moved from [a ticket on Developer Community](https://developercommunity.visualstudio.com/t/Missing-Regex-Class-Orientation-Material/10723811)._

---
[severity:It's more difficult to complete my work]
System.Text.RegularExpressions.Regex is a HUGELY important class. But there is ZERO orientation material on this web page to give the programmer/reader an overview of how it works, and different ways the designer intended it to be used, so the reader knows whether he should be doing it "one way" and looking for Captures or another way and looking for Groups.... And the orientation material SHOULD be on the page where the top level of the Regex Class is documented, and it should be the first paragraph under the title.... This kind of documentation is largely missing from a great deal of the .NET documentation. I'm surprised -- after all these years -- that it is _still_ missing....

The consequences of this is that the reader has to (painfully) study ALL the details (which takes a long time) to figure out how the designer(s) intended it to be used.... When this could be solved in a small number of paragraphs, probably less than 4. (I'm a technical writer -- trust me when I say this documentation really _needs_ that orientation material.) It makes the difference in the reader being able to competently use the Regex class in 5 minutes, vs 2+ hours....

Kind regards,
Victor Wheeler

---
### Original Comments

#### Feedback Bot on 8/16/2024, 03:15 AM:

(private comment, text removed)

---
### Original Solutions
(no solutions)

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.