Take the 2-minute tour ×
TeX - LaTeX Stack Exchange is a question and answer site for users of TeX, LaTeX, ConTeXt, and related typesetting systems. It's 100% free, no registration required.

From How to Package Your LaTeX Package tutorial:

"The important parts of a package are the code, the documentation of the code, and the user documentation."

What is the difference between documentation of the code and user documentation?

share|improve this question
6  
Boiled down: user documentation = user guide, documentation of the code = programmers guide –  jjdb Apr 14 '13 at 21:06
    

1 Answer 1

up vote 7 down vote accepted

Well, despite jjdb hit the spot with:

user documentation = user guide, documentation of the code = programmers guide

I'll try to be a little more poetic:

The user's guide, as its name implies, it is intended to be used by the user, i.e, the guy that sits behind the computer and uses your code to do whatever he needs to do.

The documentation code is part of the good practices a programmer follows in order to keep track of what he is doing, to leave clear messages for anyone who wants to touch the code and to keep his mind sanity (specially when coming back from long periods of no interaction with the code).

Basically, the user documentation should be as explicative as possible, since you don't know what is the level of understanding of the package of the person that is reading it (remember that if this is the first version, most likely nobody has ever seen it before), whereas the code documentation should be oriented to demonstrate what your code is doing and where it's doing it, so any modifications can be made as easily as possible.

share|improve this answer

Your Answer

 
discard

By posting your answer, you agree to the privacy policy and terms of service.

Not the answer you're looking for? Browse other questions tagged or ask your own question.