accumulo-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Christopher <>
Subject Re: Docs with monitor
Date Tue, 04 Jun 2013 19:36:41 GMT
That would be nice, but we should avoid relative paths in javadocs
that link externally, because they also get packaged in the -javadoc
jars, and should be independent.

Christopher L Tubbs II

On Tue, Jun 4, 2013 at 3:25 PM, Keith Turner <> wrote:
> Something I have wanted w/ Accumulo documention is have more linking (i.e.
> links to javadoc from usermanual and visa versa).  If we had a standard dir
> structure, then we could have relative links between components.
> On Tue, Jun 4, 2013 at 2:05 PM, Christopher <> wrote:
>> Documentation is spread out everywhere, and it's a bit difficult to
>> keep it consistent and up-to-date.
>> I think we should focus on keeping per-version documentation
>> up-to-date on the Accumulo website and in the user manual/book instead
>> of relying on the maintenance of random READMEs, docs/*.html on the
>> monitor, etc.
>> I opened one issue (ACCUMULO-1487) related to this, but I'm looking at
>> the links in docs/*.html and it seems they are written with the
>> assumption that they are being served from the monitor. I'm not sure
>> how useful these are. Perhaps it'd be better if these were simply
>> removed from the monitor, and replaced with a link to the website
>> documentation (link configurable)?
>> That said, it would probably benefit us to have documentation links such
>> as:
>> -> points to latest 1.5.x
>> -> points to latest overall
>> version (menu includes links to older versions)
>> -> redirects to docs/latest
>> So, this email is about two things, really:
>> 1) Improve the website with consolidated per-version documentation.
>> 2) Get rid of documentation packaged with the monitor.
>> This doesn't address the consolidation of the various READMEs, but
>> those should be addressed at some point also.
>> I also opened ACCUMULO-1490, ACCUMULO-1491 to deal with this. And, as
>> part of improvements for ACCUMULO-935, I already made a separate
>> "docs" module that could probably benefit from some further polishing.
>> Thoughts?
>> --
>> Christopher L Tubbs II

View raw message