Phango - questions

[Sean Kelly]

Christopher Wright wrote:
> Sean Kelly wrote:
>> Christopher Wright wrote:
>>> Don Clugston wrote:
>>>>
>>>> Incidentally, one stylistic change between Phobos and Tango which 
>>>> hasn't been mentioned, is that Phobos uses a flat structure (except 
>>>> for a couple of things like std.c.windows.windows!). IMHO, the flat 
>>>> structure is decidedly inferior.
>>>
>>> Why is that?
>>>
>>> I work on a decently sized (40k lines) project in C#, and we're 
>>> moving from a deep hierarchy to a shallow one -- it's less typing, 
>>> and we don't see any advantages in the deeper structure.
>>>
>>> If you point out a reasonable advantage, then I can probably work 
>>> quicker.
>>>
>>> The documentation should be hierarchical or task-oriented, of course, 
>>> so you can find what you're looking for easily.
>>
>> This is why I like deeper hierarchies.  I tend to look at the code 
>> itself for reference more often than the documentation itself, so it's 
>> nice to have the code grouped in a manner that matches the documentation.
> 
> One could argue that you just need better documentation.

Certainly.  But I've come to accept that the existence of any 
documentation at all is a rare thing, and its accuracy is equally rare. 
   Documentation also assumes the documented code is bug-free.


Sean