-
-
Notifications
You must be signed in to change notification settings - Fork 140
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.
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
Feature: Add Xml comment's for public methods and properties #169
Comments
|
This would indeed be nice. It would mean we don't have to go back and forth looking at the code and trying to find the part in the docs that explains it which is a bit frustrating right now. |
I just spend some time doing this. I added comments to the following classes:
Are there any other classes you guys regularly use where you'd like to see docs? |
Added xml comments to various classes. #169
This has been released by now. If there's more that needs documenting let me know! |
Kinda straightforwad. Can you add xml comments to public methods and properties? It's so much easier to just browse code and look up what things doing and not trying to find this one sentence in yours (very nicly done, by the way) documentation? Here is example:
public void SetGoal<TGoal>(bool endAction) where TGoal : IGoalBase { this.SetGoal(this.GoapSet.ResolveGoal<TGoal>(), endAction); }
What is this bool with endAction? I would need to refer to some place in documentation and it could be just a nice xml
/// <summary> /// Set's goal for agent. /// </summary> /// <param name="endAction">does this and this</param>
so goooooood quality of life update it would be, with a little effort!
The text was updated successfully, but these errors were encountered: