The Artima Developer Community
Sponsored Link

.NET Buzz Forum
Documentation for the masses

0 replies on 1 page.

Welcome Guest
  Sign In

Go back to the topic listing  Back to Topic List Click to reply to this topic  Reply to this Topic Click to search messages in this forum  Search Forum Click for a threaded view of the topic  Threaded View   
Previous Topic   Next Topic
Flat View: This topic has 0 replies on 1 page
Jeff Key

Posts: 481
Nickname: jeffreykey
Registered: Nov, 2003

Jeff Key is legally sane, but questionably competent.
Documentation for the masses Posted: Aug 18, 2004 7:26 PM
Reply to this message Reply

This post originated from an RSS feed registered with .NET Buzz by Jeff Key.
Original Post: Documentation for the masses
Feed Title: Jeff Key
Feed URL: http://www.asp.net/err404.htm?aspxerrorpath=/jkey/Rss.aspx
Feed Description: Topics revolve around .NET and the Windows platform.
Latest .NET Buzz Posts
Latest .NET Buzz Posts by Jeff Key
Latest Posts From Jeff Key

Advertisement

Fire up your "must install on new development machine" list and get ready to add something else.

Matt pointed me to an amazing little Visual Studio add-in called GhostDoc that produces amazingly accurate starter documentation for type members. Simply put the cursor on the member, press the hotkey and change the result, if required. A demo class is included that illustrates this perfectly. (All of these comments were generated automagically.)

 /// <summary> 
/// Gets the current directory.
/// </summary>
/// <returns></returns>
public string GetCurrentDirectory()

/// <summary>
/// Does something.
/// </summary>
public void DoSomething()

/// <summary>
/// Builds the HTML text.
/// </summary>
/// <returns></returns>
public string BuildHtmlText()

/// <summary>
/// Initializes the GUI.
/// </summary>
public void InitializeGui()

/// <summary>
/// Determines the size of the page buffer.
/// </summary>
/// <param name="initialPageBufferSize">Size of the initial page buffer.</param>
/// <returns></returns>
public int DeterminePageBufferSize(int initialPageBufferSize)

/// <summary>
/// Performs some action.
/// </summary>
public void PerformSomeAction()

/// <summary>
/// Gets or sets a value indicating whether this <see cref="Demo"/> is cool.
/// </summary>
/// <value>
/// <c>true</c> if cool; otherwise, <c>false</c>.
/// </value>
public bool Cool
{
get { return true; }
set { ; }
}

/// <summary>
/// Gets a value indicating whether [just testing].
/// </summary>
/// <value>
/// <c>true</c> if [just testing]; otherwise, <c>false</c>.
/// </value>
public bool JustTesting
{
get { return true; }
}

/// <summary>
/// Gets the <see cref="System.String"/> with the specified index.
/// </summary>
/// <value></value>
public string this[int index]
{
get { return null; }
}

How cool is that?!

Read: Documentation for the masses

Topic: Where is the compelling argument for software factories? Previous Topic   Next Topic Topic: Be a language designer redux...

Sponsored Links



Google
  Web Artima.com   

Copyright © 1996-2019 Artima, Inc. All Rights Reserved. - Privacy Policy - Terms of Use