Skip to content

Instantly share code, notes, and snippets.

@battis
Created November 8, 2013 12:44
Show Gist options
  • Save battis/7370530 to your computer and use it in GitHub Desktop.
Save battis/7370530 to your computer and use it in GitHub Desktop.
Pseudocode Example
/**
* A brief (but complete) high-level description of the function and purpose
* of the class, included as Javadoc documentation for each class.
*
* @author Seth Battis
*
*/
public class MyNiftyProgram {
/**
* A description of each instance variable/data field that you expect
* to employ in the class, along with a tentative variable
* declaration suggesting type. (Recall that good naming conventions
* will allow you to skimp on additional documentation.)
*/
private FancyPantsObject splendidTrousers;
/**
* A brief (but complete) high-level description of the major methods
* that you expect this class to require. These methods should,
* essentially, be the "verbs" that describe what this object can do.
*
* @param severityOfCrease ranges from 0-255
*/
public void creaseThoseTrousers(double severityOfCrease) {
}
/**
* Some methods may require more visual documentation. If this is the
* case, please, by all means, include that visual documentation as
* an image (or video!) file in your project repository. You can
* employ standard Javadoc semantics to reference images from your
* documentation (can = must, BTW). As in:
*
* @see https://stmarksschool.instructure.com/courses/1238
*
* or
*
* @see nameOfMyImageFile.png
*/
public void intricateFoldingStyle() {
}
}
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment