[drlvm][doc] duplicated thread manager doc in svn source tree

["Morozova, Nadezhda" <na...@intel.com>]

Hi,
I've discovered that the vm/thread/ directory has the doc/ subdirectory
with the thread manager description and supporting files.
I suggest that we remove that directory with all its contents because:
* all relevant docs are stored on the site, including the thread manager
doc (with the correct css and all)
* if not on the site, docs might exist in vm/doc directory, not in
directories of subcomponents. 
This way, we can be sure no stray doc copies appear. 

Opinions? Suggestions? 

Thanks, 
Nadya Morozova

Re: [drlvm][doc] duplicated thread manager doc in svn source tree

[Andrey Yakushev <an...@gmail.com>]

Nadya,

I prefer seIf-documented sources and so I consider files with DRLVM
documentation
    /harmony/standard/site/docs/subcomponents/drlvm
virtually placed somewhere in
    /harmony/enhanced/drlvm/trunk/.../doc
with obvious reasons why it is not such currently.

In other words doc files should be moved thus if we ever prepared
mixed source and doc bundle.

So current state is good enough for me. :)

Thanks,
Andrey


On 1/23/07, Morozova, Nadezhda <na...@intel.com> wrote:
> Andrey,
> And what about the documents on the website?
>
> Cheers,
> Nadya
>
> >-----Original Message-----
> >From: Andrey Yakushev [mailto:andrey.yakushev@gmail.com]
> >Sent: Tuesday, January 23, 2007 1:41 PM
> >To: dev@harmony.apache.org
> >Subject: Re: [drlvm][doc] duplicated thread manager doc in svn source
> tree
> >
> >I think we definitely should get rid of documents duplication. So I
> >agree with these files removing at present.
> >
> >As for vm/thread/doc directory, it can exist and contain component
> >implementation specific docs. If we ever have another TM
> >implementation it can have another impl peculiarities in
> >vm/thread_v2/doc.
> >
> >vm/doc ideally should contain generic description of VM as a set of
> >standard associated components. But it can happen sometimes in future,
> >because current docs usually combines interface and implementation
> >description.
> >
> >Thanks,
> >Andrey
> >
> >
> >On 1/19/07, Morozova, Nadezhda <na...@intel.com> wrote:
> >> Hi,
> >> I've discovered that the vm/thread/ directory has the doc/
> subdirectory
> >> with the thread manager description and supporting files.
> >> I suggest that we remove that directory with all its contents
> because:
> >> * all relevant docs are stored on the site, including the thread
> manager
> >> doc (with the correct css and all)
> >> * if not on the site, docs might exist in vm/doc directory, not in
> >> directories of subcomponents.
> >> This way, we can be sure no stray doc copies appear.
> >>
> >> Opinions? Suggestions?
> >>
> >> Thanks,
> >> Nadya Morozova
> >>
>

RE: [drlvm][doc] duplicated thread manager doc in svn source tree

["Morozova, Nadezhda" <na...@intel.com>]

Andrey,
And what about the documents on the website?

Cheers, 
Nadya
 
>-----Original Message-----
>From: Andrey Yakushev [mailto:andrey.yakushev@gmail.com]
>Sent: Tuesday, January 23, 2007 1:41 PM
>To: dev@harmony.apache.org
>Subject: Re: [drlvm][doc] duplicated thread manager doc in svn source
tree
>
>I think we definitely should get rid of documents duplication. So I
>agree with these files removing at present.
>
>As for vm/thread/doc directory, it can exist and contain component
>implementation specific docs. If we ever have another TM
>implementation it can have another impl peculiarities in
>vm/thread_v2/doc.
>
>vm/doc ideally should contain generic description of VM as a set of
>standard associated components. But it can happen sometimes in future,
>because current docs usually combines interface and implementation
>description.
>
>Thanks,
>Andrey
>
>
>On 1/19/07, Morozova, Nadezhda <na...@intel.com> wrote:
>> Hi,
>> I've discovered that the vm/thread/ directory has the doc/
subdirectory
>> with the thread manager description and supporting files.
>> I suggest that we remove that directory with all its contents
because:
>> * all relevant docs are stored on the site, including the thread
manager
>> doc (with the correct css and all)
>> * if not on the site, docs might exist in vm/doc directory, not in
>> directories of subcomponents.
>> This way, we can be sure no stray doc copies appear.
>>
>> Opinions? Suggestions?
>>
>> Thanks,
>> Nadya Morozova
>>

Re: [drlvm][doc] duplicated thread manager doc in svn source tree

[Andrey Yakushev <an...@gmail.com>]

I think we definitely should get rid of documents duplication. So I
agree with these files removing at present.

As for vm/thread/doc directory, it can exist and contain component
implementation specific docs. If we ever have another TM
implementation it can have another impl peculiarities in
vm/thread_v2/doc.

vm/doc ideally should contain generic description of VM as a set of
standard associated components. But it can happen sometimes in future,
because current docs usually combines interface and implementation
description.

Thanks,
Andrey


On 1/19/07, Morozova, Nadezhda <na...@intel.com> wrote:
> Hi,
> I've discovered that the vm/thread/ directory has the doc/ subdirectory
> with the thread manager description and supporting files.
> I suggest that we remove that directory with all its contents because:
> * all relevant docs are stored on the site, including the thread manager
> doc (with the correct css and all)
> * if not on the site, docs might exist in vm/doc directory, not in
> directories of subcomponents.
> This way, we can be sure no stray doc copies appear.
>
> Opinions? Suggestions?
>
> Thanks,
> Nadya Morozova
>