Created
November 8, 2013 12:44
-
-
Save battis/7370530 to your computer and use it in GitHub Desktop.
Pseudocode Example
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
/** | |
* 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