What is an example of user documentation? [closed]

Closed. This question needs to be more focused. It is not currently accepting answers.

---

Want to improve this question? Update the question so it focuses on one problem only by editing this post.

Closed 4 years ago.

Improve this question

I'm writing this Rational number class for one 开发者_如何学Pythonof my cs courses, using C++. We're also asked to hand in a "user documentation", which is sth that i've never done before. What is an example of user documentation? what is the format of it? Thanks!

---

"User Documentation" is written instructions you would give to someone using your software. In other words, write something that tells your end user, in this case your instructor, how to run your program.

Take a look at doxygen for a way to turn your code's comments into html user documentation.

---

Try Doxygen. It will dynamically generate some of the documentation. For an examle, look at http://www.boost.org/doc/libs/1_40_0

---

You should ask your instructor to clarify what he/she is asking for - that is what a good engineer would do...make sure to nail down the problem with the customer :)

User docs could mean:

• Source code docs (user is another program)
• README.txt file
• End-user doc in HTML, CHM, whatever

---

Take it simple... use this snippet before methods replacing wherever necessary:

//**************************************************************
// Output condition over the program after method execution
// Input variables, their type and meanings
// Return value
//**************************************************************

You should see Java API to notice how a documentation should be...