Lucene - Core
  1. Lucene - Core
  2. LUCENE-4007

many versioned documents could/should be in javadocs instead.

    Details

    • Type: Task Task
    • Status: Closed
    • Priority: Major Major
    • Resolution: Fixed
    • Affects Version/s: 4.0-ALPHA
    • Fix Version/s: 4.0-ALPHA
    • Component/s: general/website
    • Labels:
      None
    • Lucene Fields:
      New

      Description

      Looking at our forrested site, and trying to think about how we could move our versioned site
      away from it, I think as a first step we should look at what really needs to be there.

      I think it easily becomes out of date and we don't have good centralized documentation since
      stuff is split between javadocs and forrest.

      Couldn't queryparsersyntax.xml simply be in the overview/package for the queryparser?
      We could just link to that page from the forrest docs menu, then we could link to the syntax from
      other places in the javadocs.
      Furthermore, in that case we could link to other queryparser impls documentations (e.g. complexphrase)
      so it would probably be more useful.

      demo/demo2.xml could just be overview for the demo contrib? currently that one is useless:
      https://builds.apache.org/job/Lucene-trunk/javadoc/demo/index.html

      scoring.xml could be added to the package documentation of search or similarities or somewhere that
      makes more sense? currently its "almost javadocs" already, except harder to validate none of these
      links are actually out of date: my best bet is a ton of them already are!

      i'll leave fileformats.xml aside for now, but with many different codec implementations its something
      to think about for later too.

      1. LUCENE-4007.patch
        130 kB
        Uwe Schindler
      2. LUCENE-4007.patch
        1.74 MB
        Uwe Schindler
      3. LUCENE-4007.patch
        1.74 MB
        Uwe Schindler

        Activity

          People

          • Assignee:
            Uwe Schindler
            Reporter:
            Robert Muir
          • Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

            Dates

            • Created:
              Updated:
              Resolved:

              Development