Morozova, Nadezhda wrote:
Hi,
Suggested are a few tricks to improve navigation on the website, thanks
(see answers below).
More responses are welcome. Do you, your relatives or friends have ideas
on improving our site? I remember Egor asked his Dad to surf and Geir
had a cool Granny knitting the GC<>JIT sweater...
* It's ok to keep references at the first page.
I think we can edit the frontpage slightly to make more important staff
stand out. I mean, I get lost each time I visit the front page!
We could - when are snapshot gets a little better, maybe we do something
a la the NetBeans or Eclipse site...
* Let's add build instruction to the documentation map.
You mean links to the instructions, right? Great idea, but I'd rather be
more radical with it. The current page Documentation is hardly useful.
What do you think of replacing it with some sort of Site Map with links
to all sources of resources we have?
Cool
* Let's add build instruction to "Get involved".
Ok
How about just a link
* Let's remove "Source code" section at all or replace it with a
reference to ViewSvn.
I'd not hurry to do that. I like the Source Code page as is because it
explains different ways of accessing the source code, not just viewsvn.
However, making the viewsvn link more prominent does make sense to me.
Agreed
Cheers,
Nadya
-----Original Message-----
From: Alexei Fedotov [mailto:[EMAIL PROTECTED]
Sent: Friday, December 01, 2006 1:14 AM
To: [email protected]
Subject: [doc][user experience] simple navigation on the web site Was:
svn
commit: r480884 - in /harmony/standard/site: docs/downloads.html
docs/quickhelp_users.html xdocs/downloads.xml xdocs/quickhelp_users.xml
Nadya,
Due to resource location changes my hand-made scripts stopped to work:
all security tests failed with "*** implementation not found". I
decided to get used to Geir's federated build.
I tried to find quickly quickhelp_contributors.html serfing our web
site. I stopped reading the first page right after the words: "Big
News: Apache Harmony is a top-level project of the Apache Software
Foundation! See below for more information."
After visiting "Documentation", "Get Involved", "Source Code",
"DRLVM", "Contribution Policy" sections I used search in my mailbox
and found that you added this reference to "Downloads" section. This
is a good location, but it didn't yet appeared at the actual web site.
I decided to download the web site and use search.
$ grep -rl quickhelp_contributors
harmony.apache.org/harmony.apache.org/index.html
harmony.apache.org/quickhelp_users.html
harmony.apache.org/subcomponents/buildtest/index.html
harmony.apache.org/subcomponents/classlibrary/index.html
There are plenty of places, though I missed them. I believe we need do
the following:
* It's ok to keep references at the first page.
* Let's add build instruction to the documentation map.
* Let's add build instruction to "Get involved".
* Let's remove "Source code" section at all or replace it with a
reference to ViewSvn.
What do u think?
With best regards,
Alexei
On 11/30/06, [EMAIL PROTECTED] <[EMAIL PROTECTED]> wrote:
Author: nadinem
Date: Thu Nov 30 02:11:14 2006
New Revision: 480884
URL: http://svn.apache.org/viewvc?view=rev&revH0884
Log:
Resolve HARMONY-1730: applied patches downloads.patch;
quickhelp_users.patch
Modified:
harmony/standard/site/docs/downloads.html
harmony/standard/site/docs/quickhelp_users.html
harmony/standard/site/xdocs/downloads.xml
harmony/standard/site/xdocs/quickhelp_users.xml
Modified: harmony/standard/site/docs/downloads.html
URL:
http://svn.apache.org/viewvc/harmony/standard/site/docs/downloads.html?
view
=diff&revH0884&r1H0883&r2H0884
=======================================================================
====
==
--- harmony/standard/site/docs/downloads.html (original)
+++ harmony/standard/site/docs/downloads.html Thu Nov 30 02:11:14
2006
@@ -214,13 +214,17 @@
<p>
Access to <a href="svn.html">the code repository</a>
is
available to all, and we have
<a
href="documentation/documentation.html">instructions</a> for building
the
- virtual machine code and <a
href="documentation/build_classlib.html">
- building the class library code</a>.
- </p>
+ virtual machine code. For information on how to get
configured to build and
+ work with the Apache Harmony source code, refer to
+ <a
href="http://incubator.apache.org/harmony/quickhelp_contributors.html";>
+ Getting Started For Contributors</a>. For instructions on how
to
point to local
+ versions instead of making the build download new ones from the
net,
refer to the
+ <a
href="http://svn.apache.org/viewvc/incubator/harmony/enhanced/drlvm/tru
nk/R
EADME.txt?view=co">
+ README file</a>.
+ </p>
<p>
- However, if you don't want to build it, we now offer
snapshots
of our JRE and
- <a href="subcomponents/classlibrary/hdk.html">HDK</a>
- for Linux and Windows x86-based platforms.
+ However, if you don not want to build it, we now offer
snapshots
of our JRE and HDK
+ for the Linux and Windows platforms.
</p>
<h2>
Modified: harmony/standard/site/docs/quickhelp_users.html
URL:
http://svn.apache.org/viewvc/harmony/standard/site/docs/quickhelp_users
.htm
l?view=diff&revH0884&r1H0883&r2H0884
=======================================================================
====
==
--- harmony/standard/site/docs/quickhelp_users.html (original)
+++ harmony/standard/site/docs/quickhelp_users.html Thu Nov 30
02:11:14
2006
@@ -229,7 +229,7 @@
</h2>
<p>
- First of all, download the binary distribution
appropriate
to
+ First, download the binary distribution appropriate to
your platform. We currently distribute binaries for Linux
and
Microsoft Windows. Please follow the instructions on the
<a href="downloads.html">download page</a>
@@ -248,10 +248,10 @@
</h2>
<p>
- Once you have obtained the appropriate binary
distribution,
- you need to unpack it on your machine. In all cases, the
+ Once you have obtained the appropriate binary
distribution,
+ you need to unpack it on your machine. In all cases, the
distribution will unpack into a <code>jre</code>
- directory. Further in the document we refer to this
directory
+ directory. Further in the document we refer to this
directory
as the <i>root directory</i> of the distribution.
</p>
<strong>Linux Users</strong>
@@ -266,19 +266,19 @@
</p>
<strong>Windows Users</strong>
<p>
- Use one of <code>zip</code> utilities available for
Windows to
- unpack the distribution. The three popular ones are listed
- below, but anything that can handle a <code>zip</code>
file
+ Use one of <code>zip</code> utilities available for
Windows to
+ unpack the distribution. The three popular ones are listed
+ below, but anything that can handle a <code>zip</code>
file
will work:
</p>
<ul>
- <li><a href="http://www.info-zip.org/";>Info-ZIP</a>
+ <li><a href="http://www.info-zip.org/";>Info-ZIP</a>
(open source software)</li>
<li><a href="http://www.7-zip.org/";>7-Zip</a> (free
software)</li>
<li><a href="http://www.winzip.com/";>Winzip</a>
(commercial)</li>
</ul>
<p>
- To create the JRE directory tree, extract the
+ To create the JRE directory tree, extract the
distribution <code>zip</code> file using the utility.
</p>
@@ -288,13 +288,13 @@
</h2>
<p>
- Apache Harmony requires no further environmental setup,
but
- sometimes other programs do. Also, it is convenient to
have
+ Apache Harmony requires no further environmental setup,
but
+ sometimes other programs do. Also, it is convenient to
have
the Apache Harmony executables on your path.
</p>
<p>
- To set your <code>JAVA_HOME</code> and <code>PATH</code>
- environment variables, use the commands appropriate to
your
+ To set your <code>JAVA_HOME</code> and <code>PATH</code>
+ environment variables, use the commands appropriate to
your
operating system and/or shell you are using.
</p>
<strong>
@@ -309,11 +309,11 @@
$ export PATH=`pwd`:$PATH
</pre>
<p>
- The given command assumes your current directory is the
parent
- directory of the Harmony JRE.
+ The given command assumes your current directory is the
parent
+ directory of the Harmony JRE.
</p>
<p class="note">Note</p>
- <p class="notetext">The
<code>`</code>
character is a backtick character,
+ <p class="notetext">The
<code>`</code>
character is a backtick character,
not an apostrophe.</p>
<strong>Windows Users</strong>
<p>
@@ -334,9 +334,9 @@
</h2>
<p>
- After performing aforementioned steps, you should be
ready
to use
+ After performing aforementioned steps, you should be
ready
to use
Apache Harmony. Note that we have not yet included
- <code>javac</code>, so continue to use the compiler from
some
+ <code>javac</code>, so continue to use the compiler from
some
other JRE. You should have no problems running programs.
</p>
<pre>
Modified: harmony/standard/site/xdocs/downloads.xml
URL:
http://svn.apache.org/viewvc/harmony/standard/site/xdocs/downloads.xml?
view
=diff&revH0884&r1H0883&r2H0884
=======================================================================
====
==
--- harmony/standard/site/xdocs/downloads.xml (original)
+++ harmony/standard/site/xdocs/downloads.xml Thu Nov 30 02:11:14
2006
@@ -34,14 +34,18 @@
<p>
Access to <a href="svn.html">the code repository</a>
is
available to all, and we have
<a
href="documentation/documentation.html">instructions</a> for building
the
- virtual machine code and <a
href="documentation/build_classlib.html">
- building the class library code</a>.
- </p>
+ virtual machine code. For information on how to get
configured to build and
+ work with the Apache Harmony source code, refer to
+ <a
href="http://incubator.apache.org/harmony/quickhelp_contributors.html";>
+ Getting Started For Contributors</a>. For instructions on how
to
point to local
+ versions instead of making the build download new ones from the
net,
refer to the
+ <a
href="http://svn.apache.org/viewvc/incubator/harmony/enhanced/drlvm/tru
nk/R
EADME.txt?view=co">
+ README file</a>.
+ </p>
<p>
- However, if you don't want to build it, we now offer
snapshots
of our JRE and
- <a href="subcomponents/classlibrary/hdk.html">HDK</a>
- for Linux and Windows x86-based platforms.
+ However, if you don not want to build it, we now offer
snapshots
of our JRE and HDK
+ for the Linux and Windows platforms.
</p>
<subsection name="Snapshot Builds">
Modified: harmony/standard/site/xdocs/quickhelp_users.xml
URL:
http://svn.apache.org/viewvc/harmony/standard/site/xdocs/quickhelp_user
s.xm
l?view=diff&revH0884&r1H0883&r2H0884
=======================================================================
====
==
--- harmony/standard/site/xdocs/quickhelp_users.xml (original)
+++ harmony/standard/site/xdocs/quickhelp_users.xml Thu Nov 30
02:11:14
2006
@@ -48,7 +48,7 @@
<subsection name="Download the Apache Harmony Snapshot">
<p>
- First of all, download the binary distribution
appropriate
to
+ First, download the binary distribution appropriate to
your platform. We currently distribute binaries for Linux
and
Microsoft Windows. Please follow the instructions on the
<a href="downloads.html">download page</a>
@@ -66,10 +66,10 @@
<subsection name="Unpack the Binary Distribution">
<p>
- Once you have obtained the appropriate binary
distribution,
- you need to unpack it on your machine. In all cases, the
+ Once you have obtained the appropriate binary
distribution,
+ you need to unpack it on your machine. In all cases, the
distribution will unpack into a <code>jre</code>
- directory. Further in the document we refer to this
directory
+ directory. Further in the document we refer to this
directory
as the <i>root directory</i> of the distribution.
</p>
@@ -90,34 +90,34 @@
<strong>Windows Users</strong>
<p>
- Use one of <code>zip</code> utilities available for
Windows to
- unpack the distribution. The three popular ones are listed
- below, but anything that can handle a <code>zip</code>
file
+ Use one of <code>zip</code> utilities available for
Windows to
+ unpack the distribution. The three popular ones are listed
+ below, but anything that can handle a <code>zip</code>
file
will work:
</p>
<ul>
- <li><a href="http://www.info-zip.org/";>Info-ZIP</a>
+ <li><a href="http://www.info-zip.org/";>Info-ZIP</a>
(open source software)</li>
<li><a href="http://www.7-zip.org/";>7-Zip</a> (free
software)</li>
<li><a href="http://www.winzip.com/";>Winzip</a>
(commercial)</li>
</ul>
<p>
- To create the JRE directory tree, extract the
+ To create the JRE directory tree, extract the
distribution <code>zip</code> file using the utility.
</p>
</subsection>
<subsection name="Configuring Your Environment">
<p>
- Apache Harmony requires no further environmental setup,
but
- sometimes other programs do. Also, it is convenient to
have
+ Apache Harmony requires no further environmental setup,
but
+ sometimes other programs do. Also, it is convenient to
have
the Apache Harmony executables on your path.
</p>
<p>
- To set your <code>JAVA_HOME</code> and <code>PATH</code>
- environment variables, use the commands appropriate to
your
+ To set your <code>JAVA_HOME</code> and <code>PATH</code>
+ environment variables, use the commands appropriate to
your
operating system and/or shell you are using.
</p>
@@ -136,11 +136,11 @@
</source>
<p>
- The given command assumes your current directory is the
parent
- directory of the Harmony JRE.
+ The given command assumes your current directory is the
parent
+ directory of the Harmony JRE.
</p>
<p class="note">Note</p>
- <p class="notetext">The <code>`</code> character is a backtick
character,
+ <p class="notetext">The <code>`</code> character is a backtick
character,
not an apostrophe.</p>
<strong>Windows Users</strong>
@@ -164,9 +164,9 @@
<subsection name="Using Apache Harmony">
<p>
- After performing aforementioned steps, you should be
ready
to use
+ After performing aforementioned steps, you should be
ready
to use
Apache Harmony. Note that we have not yet included
- <code>javac</code>, so continue to use the compiler from
some
+ <code>javac</code>, so continue to use the compiler from
some
other JRE. You should have no problems running programs.
</p>
--
Thank you,
Alexei
