From: cis.ohio-state.edu!zaphod.mps.ohio-state.edu!howland.reston.ans.net!bogus
Subject: Re: Documenting Individual Objects
Date: 21 Apr 93 22:20:01 GMT [thread overview]
Message-ID: <thinmanC5uu1E.Hyo@netcom.com> (raw)
johnson@cs.uiuc.edu (Ralph Johnson) writes:
>> ...
>The reason for this is that (in my opinion) documenting a single
>class is easy, and is similar to traditional function-oriented
>documentation, but documenting object-interactions is much harder.
>For example, in Smalltalk I am perfectly happy with class comments
>and method comments as documentation for a class, but they fall apart
>as documentation for how objects work together.
Perhaps you should be able to specify when and how objects interact?
Then you wouldn't need to document... the code would serve.
--
Lance Norskog
thinman@netcom.com
Data is not information is not knowledge is not wisdom.
next reply other threads:[~1993-04-21 22:20 UTC|newest]
Thread overview: 9+ messages / expand[flat|nested] mbox.gz Atom feed top
1993-04-21 22:20 cis.ohio-state.edu!zaphod.mps.ohio-state.edu!howland.reston.ans.net!bogus [this message]
-- strict thread matches above, loose matches on Subject: below --
1993-04-27 13:03 Documenting Individual Objects agate!howland.reston.ans.net!usc!cs.utexas.edu!utnut!torn!nott!bnrgate!bn
1993-04-26 13:32 agate!howland.reston.ans.net!zaphod.mps.ohio-state.edu!darwin.sura.net!ne
1993-04-24 2:59 mole-end!mat
1993-04-23 16:26 Terry
1993-04-22 19:20 cis.ohio-state.edu!pacific.mps.ohio-state.edu!zaphod.mps.ohio-state.edu!u
1993-04-22 12:41 howland.reston.ans.net!bogus.sura.net!darwin.sura.net!news.duc.auburn.edu
1993-04-21 17:38 cis.ohio-state.edu!zaphod.mps.ohio-state.edu!usc!news.bbn.com!ulowell!swl
1993-04-20 17:08 Ralph Johnson
replies disabled
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox