You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@harmony.apache.org by "Morozova, Nadezhda" <na...@intel.com> on 2006/08/01 16:43:11 UTC

[doc]proposal to improve and expand website

Geir, all, 

I have thought that I could contribute by brushing up and expanding some
of the pages on the Harmony website. My first attempt has been to edit
the FAQ section, see JIRA issue 1032 [1]. 

Another thing I could do is to add content to the DRLVM page (a newly
added page with no content so far). I thought that placing links to
various docs we have for DRLVM now could be useful. If nobody is against
this, I could produce a trial patch shortly. 

One technical question: if I place links to documents that go into SVN
and check out the latest version, the link takes you to the HTML doc
with no images or styles displayed. As I understand, Geir has overcome
this difficulty when linking from the Documentation page to descriptions
of classlib bundles by copying the docs into the site/docs/externals
directory. Should I do that for Getting Started, Developer's Guide and
any other HTML docs I find for DRLVM? 

Note: the ClassLibrary page [2], section Architecture and Guide has
links to external sources [3] that are also HTML displayed with no
styles or formatting or images. Perhaps, we should also fix that
somehow. 

 

 

[1] JIRA 1032, https://issues.apache.org/jira/browse/HARMONY-1032 

[2] ClassLib page
http://incubator.apache.org/harmony/subcomponents/classlibrary/index.htm
l 

[3] link to porting docs,
http://svn.apache.org/viewvc/incubator/harmony/enhanced/classlib/trunk/d
oc/vm_doc/html/index.html?view=co 

 

Nadya Morozova, 

Technical writer 

 

 


Re: [doc]proposal to improve and expand website

Posted by Geir Magnusson Jr <ge...@pobox.com>.

Salikh Zakirov wrote:
> Geir Magnusson Jr wrote:
>> Morozova, Nadezhda wrote:
>>> Geir, all, 
>>>
>>> I have thought that I could contribute by brushing up and expanding some
>>> of the pages on the Harmony website. My first attempt has been to edit
>>> the FAQ section, see JIRA issue 1032 [1]. 
>> Patch applied and committed
> 
> Somehow, the change is not visible on the site. The FAQ is still rendered
> as <pre>text</pre>.

Ah, thanks.  I forgot to push the site out.  I was pondering the other
site patches before I did that, and at some point fell over and went to bed.

Done.  It should be synched w/in a few hours.

geir

---------------------------------------------------------------------
Terms of use : http://incubator.apache.org/harmony/mailing.html
To unsubscribe, e-mail: harmony-dev-unsubscribe@incubator.apache.org
For additional commands, e-mail: harmony-dev-help@incubator.apache.org


Re: [doc]proposal to improve and expand website

Posted by Salikh Zakirov <Sa...@Intel.com>.
Geir Magnusson Jr wrote:
> 
> Morozova, Nadezhda wrote:
>> Geir, all, 
>>
>> I have thought that I could contribute by brushing up and expanding some
>> of the pages on the Harmony website. My first attempt has been to edit
>> the FAQ section, see JIRA issue 1032 [1]. 
> 
> Patch applied and committed

Somehow, the change is not visible on the site. The FAQ is still rendered
as <pre>text</pre>.


---------------------------------------------------------------------
Terms of use : http://incubator.apache.org/harmony/mailing.html
To unsubscribe, e-mail: harmony-dev-unsubscribe@incubator.apache.org
For additional commands, e-mail: harmony-dev-help@incubator.apache.org


Re: [doc]proposal to improve and expand website

Posted by Geir Magnusson Jr <ge...@pobox.com>.

Morozova, Nadezhda wrote:
> Geir, all, 
> 
> I have thought that I could contribute by brushing up and expanding some
> of the pages on the Harmony website. My first attempt has been to edit
> the FAQ section, see JIRA issue 1032 [1]. 

Patch applied and committed

> 
> Another thing I could do is to add content to the DRLVM page (a newly
> added page with no content so far). I thought that placing links to
> various docs we have for DRLVM now could be useful. If nobody is against
> this, I could produce a trial patch shortly. 

Yep, that would be wonderful.

> 
> One technical question: if I place links to documents that go into SVN
> and check out the latest version, the link takes you to the HTML doc
> with no images or styles displayed. As I understand, Geir has overcome
> this difficulty when linking from the Documentation page to descriptions
> of classlib bundles by copying the docs into the site/docs/externals
> directory. Should I do that for Getting Started, Developer's Guide and
> any other HTML docs I find for DRLVM? 

Yes - until we federate all of this stuff, lets use the externals as a
"read only" copy for this.

> 
> Note: the ClassLibrary page [2], section Architecture and Guide has
> links to external sources [3] that are also HTML displayed with no
> styles or formatting or images. Perhaps, we should also fix that
> somehow. 

Somehow.  Suggestions welcome.

geir

> 
>  
> 
>  
> 
> [1] JIRA 1032, https://issues.apache.org/jira/browse/HARMONY-1032 
> 
> [2] ClassLib page
> http://incubator.apache.org/harmony/subcomponents/classlibrary/index.htm
> l 
> 
> [3] link to porting docs,
> http://svn.apache.org/viewvc/incubator/harmony/enhanced/classlib/trunk/d
> oc/vm_doc/html/index.html?view=co 
> 
>  
> 
> Nadya Morozova, 
> 
> Technical writer 
> 
>  
> 
>  
> 
> 

---------------------------------------------------------------------
Terms of use : http://incubator.apache.org/harmony/mailing.html
To unsubscribe, e-mail: harmony-dev-unsubscribe@incubator.apache.org
For additional commands, e-mail: harmony-dev-help@incubator.apache.org