harmony-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Geir Magnusson Jr." <g...@pobox.com>
Subject Re: [doc] Documentation in classlib and on the web site is duplicated
Date Fri, 24 Nov 2006 16:46:33 GMT

Anton Rusanov wrote:
> I have noted that the some docs in standard/site/docs are equal to
> ones in enhanced/classlib/trunk/doc. This duplication seems strange to
> me. Why is it done in this way?

Are you sure there's duplication and not a svn extern for the site?  I 
added an extern link for some things to prevent duplication.


> Currently it can happen that two people update separate copies of one
> document (Ann changes
> standard/site/docs/subcomponents/classlibrary/asn1_framework.html and
> Bob makes fixes in
> enhanced/classlib/trunk/doc/security/ASN1Framework.htm) and we can get
> two incomplete versions of a doc.
> I think the better way is to have one source that contains the docs so
> that the changes are automatically reflected at all places.
> This can be achieved by e.g. having only links to
> enhanced/classlib/trunk/doc on the web site, but not a copy.
> One more thing is that some time ago there was a link from the site to
> the Keytool user guide. Now it is missing. Can it be returned back to
> site?

View raw message