dotnet / dotnet/dotnet-api-docs
Missing Regex Class Orientation Material
- 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
Assessment
This issue has not been assessed yet.