--- Julia Thompson <[EMAIL PROTECTED]> wrote:
> Jan Coffey wrote:
>
> > So Rich, don't blame a lack of documentation for poorly factored code.
> > Instead of "If these idiots would just have documented...", think "If
> these
> > idiots would just have written Unit Tests or Contracts, written clear
code
> > with short methods and descriptive naming, used coding conventions like
> > vertical alignment, used comments when the intent was not obvious, and
> > documented their intent in a short and concise manner."
>
> Can you explain "factored"? Thanks!
>
2.9 Well-Factored
The definition of well-factored is slightly different for each tier of a
system, but the underlying and consistent theme is abstraction and
segregation, the idea that each concept or function is contained in a
separate modular entity. That entity could be a variable, a function,
structure, class, framework, component, service, application, system, or
architecture. This means that well-factoredness is not only necessary for
reuse, but that by it�s very nature, reuse is necessary for
well-facotrensess. To be well-factored Object Oriented source code should
follow the principles of OOD.
Well factored can also be used in a discussion of coding (not code) structure
for a particular environment, (i.e.) That proven standards have been
followed. Such standards might include but are not limited to: The use of
Unit Tests or some form of testable or probable contract specification, Short
concise methods, The use of highly informative naming structures such as
Hungarian notation, The use of a scanable format with vertical alignment and
right aligned comments when interspersed commenting is needed., The use of
descriptive naming and self documenting naming techniques. etc.
"Poorly-Factored" is the opposite.
"Re-Factored" is the modification of an asset to make the asset more
well-factored, or to accommodate a change in the required contract.
Jan
=====
_________________________________________________
Jan William Coffey
_________________________________________________
__________________________________
Do you Yahoo!?
Yahoo! Calendar - Free online calendar with sync to Outlook(TM).
http://calendar.yahoo.com
_______________________________________________
http://www.mccmedia.com/mailman/listinfo/brin-l
