active-logic / active-logic/debug-chan

Discuss and implement diagnostic levels

オープン
#38 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る
debug-chan enhancement
主要言語
C#
スター
17
フォーク
0
PR マージ指標
30日以内にマージされた PR はありません

説明

Currently Debug-Chan does not offer diagnostic levels. For many projects, will not scale.

Ideas:
- Severity/LOD in general is *not* a great concept. A severity of 0, 1, 2, ... does not mean much. However, users may assign meaning to these (accept custom enums if easy enough)
- Debug-Chan is a logging tool. Its primary purpose is offering information beyond warnings and errors (happy to keep warnings and errors in the Unity console)
- Logging from public/protected/private... channeling based on this would be somewhat meaningful; don't think C# diagnostics include this but can get at it.

If there's a need to refine the debug chan APIs, how I see it -
- A log message expressing actual change (data write) is informative
- A log message clarifying control, but no mutation, is diagnostic
- Two-level messages including informative + diagnostic component may be good
- A `QA` API may be helpful to log key milestones which are also useful for validating features (as opposed to investigating issues)
- Ordinarily, we do not want objects to log when they can be described as "doing nothing" (quiescence rule) - that is, unless we think they should be doing something.

The core API should avoid overreach (log the way you want!); maybe attaching an int representing a channel / target will suffice; still, an optional API normalizing a good approach?

コントリビューションガイド

コントリビューションガイドを開く

評価

この issue はまだ評価されていません。

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。