Mailing-List: contact log4j-dev-help@logging.apache.org; run by ezmlm
Precedence: bulk
Reply-To: "Log4J Developers List" <log4j-dev@logging.apache.org>
Received-SPF: pass (athena.apache.org: domain of garydgregory@gmail.com
 designates 209.85.214.48 as permitted sender)
References: <55D8D7F1-C57F-4AAE-9B5B-70C864973DCD@nicholaswilliams.net>
From: Gary Gregory <garydgregory@gmail.com>
Mime-Version: 1.0 (1.0)
In-Reply-To: <55D8D7F1-C57F-4AAE-9B5B-70C864973DCD@nicholaswilliams.net>
Date: Wed, 17 Jul 2013 20:02:20 -0400
Message-ID: <-5102923463236849147@unknownmsgid>
Subject: Re: Javadoc Links
To: Log4J Developers List <log4j-dev@logging.apache.org>
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: quoted-printable

The Javadoc should be at the top level I think. It could be I the
manual too, since it does document the API, as an exhaustive
reference. I agree that it is too hard to find it now.

Gary

On Jul 17, 2013, at 19:56, Nick Williams <nicholas@nicholaswilliams.net> wr=
ote:

> The Javadoc on the site is very non-obvious to find (actually it's just d=
ownright improbable to find if you don't already know where to look ... I h=
ad to email the user list and ask where it was the first time I tried to fi=
nd it). I'd like to add a dedicated link on the left-hand menu that expands=
 (with an arrow beside it, like the links under the manual) and provides qu=
ick links to the Javadoc for all the components.
>
> Where do y'all think I should put it? Under "APACHE LOG4J 2" near the top=
 is similar to where the Javadoc links are on many other Apache projects, l=
ike all of the Commons projects. That is probably my preferred location. I =
could also put it under "MANUAL," at the bottom of the manual section. That=
 was my first instinct, actually, but I'm uncertain as to whether the Javad=
oc is part of the "manual," and that section is getting rather full. The on=
ly other place it might make sense is under the "LOG4J PROJECT INFORMATION"=
 section, but that's all the way down at the bottom, and I don't really lik=
e users having to scroll that far for Javadoc.
>
> Thoughts?
>
> Nick
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: log4j-dev-unsubscribe@logging.apache.org
> For additional commands, e-mail: log4j-dev-help@logging.apache.org
>

---------------------------------------------------------------------
To unsubscribe, e-mail: log4j-dev-unsubscribe@logging.apache.org
For additional commands, e-mail: log4j-dev-help@logging.apache.org