Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Document stacktrace structure/formatting #42927

Open
matthew-carroll opened this issue Aug 4, 2020 · 0 comments
Open

Document stacktrace structure/formatting #42927

matthew-carroll opened this issue Aug 4, 2020 · 0 comments
Labels
area-documentation Prefer using 'type-documentation' and a specific area label.

Comments

@matthew-carroll
Copy link

I'm filing this issue after the following discussion in the language SDK:

#42916

Logging packages and various other systems depends upon the structure of stack traces, and the ability to parse that structure, yet those stack traces are produced with a non-descript toString() method within StackTrace:

https://api.flutter.dev/flutter/dart-core/StackTrace/toString.html

I would like to suggest the introduction of clear documentation that communicates:

  • the implicit importance of this particular toString() method
  • why the language doesn't offer a structural solution
  • where developers should go to find a structural solution
@matthew-carroll matthew-carroll mentioned this issue Aug 4, 2020
Closed
@srawlins srawlins added the area-documentation Prefer using 'type-documentation' and a specific area label. label Aug 4, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
area-documentation Prefer using 'type-documentation' and a specific area label.
Projects
None yet
Milestone
No milestone
Development

No branches or pull requests
2 participants
@srawlins @matthew-carroll