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.

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

Adding Method Summary #90

Open
chrisjohnson2134 opened this issue May 19, 2020 · 3 comments
Open

Adding Method Summary #90

chrisjohnson2134 opened this issue May 19, 2020 · 3 comments

Comments

@chrisjohnson2134
Copy link

I was wondering how I could go about adding a method summary to this code that would list all the methods in a class?
'''
/// summary>
/// Class of Pugs
/// /summary>
/// method name="bark">
/// method name="sniff">
public class pugs{
public pugs(string name){
}
public void bark(string sound){
}
public void sniff(){
}
}
'''

@kasecato kasecato self-assigned this May 20, 2020
@kasecato
Copy link
Owner

Hello @chrisjohnson2134 , that feature seems to be useful. Do you know the reference point where the specifications for <method name=> tag for Documentation comments are written?

Standard ECMA-334, C# Language Specification, 5th edition (December 2017), p 477

@chrisjohnson2134
Copy link
Author

chrisjohnson2134 commented May 20, 2020

I want to thank you for reaching out, I was unaware that the 'method' wasn't a tag. However I still do want to implement the list of methods to summarize the class, would it make sense to make a list in the summary? I'm assuming not because it would mess up the scheme. Would it make more sense to allow the XML comment to be made and then a sub-header of the method names, like so?

'''
/// summary>
/// Class of Pugs
/// /summary>
/* Constructors
*-> Constructor - params (name) # (short description)
*Public Methods
*-> bark - params (sound) # (short description)
*-> sniff # (short description)
*/
public class pugs{
public pugs(string name){
}
public void bark(string sound){
}
public void sniff(){
}
}
'''

@kasecato
Copy link
Owner

So that's what you meant. I think that's a good idea. If it's standardized, I'd love to implement it 👍

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants