accumulo-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Keith Turner <>
Subject Re: Docs with monitor
Date Tue, 04 Jun 2013 19:25:03 GMT
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

  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message