Details

    • Type: Task Task
    • Status: Closed
    • Priority: Minor Minor
    • Resolution: Fixed
    • Affects Version/s: 10.5.1.1
    • Fix Version/s: 10.6.1.0
    • Component/s: Web Site
    • Labels:
      None

      Description

      The FAQ at http://db.apache.org/derby/faq.html should be updated for Derby version 10.5.

      At least the following two entries should be updated:

      • 4.7. Does Derby have a mode that causes it to run entirely in memory?
      • 5.2. Does Derby support a LIMIT command?

      We may also want to add more recent news for these:

      • 5.3. Why do I get the error 'schema does not exist'? [is this an issue still?]
      • 5.5. Can Derby generate unique identifiers like sequences?

      Finally, a general task:

      • Update links to the 10.2 docs to a newer revision [where appropriate], i.e. the 10.5 docs or even the trunk?

      There may be more items to fix.

      1. xml.diff
        6 kB
        Bryan Pendleton
      2. fixSearchFAQ.diff
        18 kB
        Bryan Pendleton
      3. faq.html
        35 kB
        Bryan Pendleton
      4. asBuilt.diff
        18 kB
        Bryan Pendleton

        Issue Links

          Activity

          Hide
          Kristian Waagan added a comment -

          I'm considering this issue completed. Thank you, Bryan!

          Show
          Kristian Waagan added a comment - I'm considering this issue completed. Thank you, Bryan!
          Hide
          Bryan Pendleton added a comment -

          Thanks Kristian! It seems that I had some sort of browser caching problem that
          was clouding my mind; when I shift-reloaded the page it indeed came up with
          the updated version.

          Show
          Bryan Pendleton added a comment - Thanks Kristian! It seems that I had some sort of browser caching problem that was clouding my mind; when I shift-reloaded the page it indeed came up with the updated version.
          Hide
          Kristian Waagan added a comment -

          Your changes are visible now, so I guess it just took a while before the sync happened.
          The paper you refer to is most likely written by someone in the Derby community, whereas the sync schedule is set by the infra team. I wouldn't be surprised if the schedule changed during the last years

          Show
          Kristian Waagan added a comment - Your changes are visible now, so I guess it just took a while before the sync happened. The paper you refer to is most likely written by someone in the Derby community, whereas the sync schedule is set by the infra team. I wouldn't be surprised if the schedule changed during the last years
          Hide
          Bryan Pendleton added a comment -

          I signed on to people.apache.org and updated /www/db.apache.org/derby/faq.html from subversion,
          but the change is not visible at http://db.apache.org/derby/faq.html.

          According to http://db.apache.org/derby/papers/derby_web.html#9.+Make+web+site+changes+visible
          "www.apache.org automatically syncs up with people.apache.org every couple hours"
          but maybe that process is not working?

          Anybody know how this process is supposed to work?

          Show
          Bryan Pendleton added a comment - I signed on to people.apache.org and updated /www/db.apache.org/derby/faq.html from subversion, but the change is not visible at http://db.apache.org/derby/faq.html . According to http://db.apache.org/derby/papers/derby_web.html#9.+Make+web+site+changes+visible "www.apache.org automatically syncs up with people.apache.org every couple hours" but maybe that process is not working? Anybody know how this process is supposed to work?
          Hide
          Bryan Pendleton added a comment -

          Committed to the site trunk as revision 832277.

          Show
          Bryan Pendleton added a comment - Committed to the site trunk as revision 832277.
          Hide
          Bryan Pendleton added a comment -

          Thanks for catching that 10.2 reference, Kristian; I've fixed it in this latest patch.

          I don't think the changes to forrest.properties loses any important functionality from Forrest; I didn't see any warnings to that effect in the FOR-984 bug report.
          But I don't have a lot of experience with Forrest.

          I ran the w3.org link checker, but decided not to make any additional changes
          to the faq at this time. I think it would be great if you can look at some of those
          link problems if you get time.

          In the meantime, I intend to commit this patch, and see if I can finish following the build instructions so that these changes go live on the site.

          Show
          Bryan Pendleton added a comment - Thanks for catching that 10.2 reference, Kristian; I've fixed it in this latest patch. I don't think the changes to forrest.properties loses any important functionality from Forrest; I didn't see any warnings to that effect in the FOR-984 bug report. But I don't have a lot of experience with Forrest. I ran the w3.org link checker, but decided not to make any additional changes to the faq at this time. I think it would be great if you can look at some of those link problems if you get time. In the meantime, I intend to commit this patch, and see if I can finish following the build instructions so that these changes go live on the site.
          Hide
          Kristian Waagan added a comment -

          Thanks for doing this, Bryan.

          The changes look good, I only have the following comments:

          • version inconsistency under "How do I search the Derby site?" (10.2 != 10.5)
          • the attached page looks a bit different, and I assume that's because it is displayed without using any stylesheets.
          • there are several problems with links in the FAQ (not related to your changes). Unless you want to have a look at this yourself, I can have a look at it after you have committed your changes (running http://validator.w3.org/checklink is a good first step).

          +1 to commit.

          Regarding the disabled checks, are there configurations were they do us any good?

          Show
          Kristian Waagan added a comment - Thanks for doing this, Bryan. The changes look good, I only have the following comments: version inconsistency under "How do I search the Derby site?" (10.2 != 10.5) the attached page looks a bit different, and I assume that's because it is displayed without using any stylesheets. there are several problems with links in the FAQ (not related to your changes). Unless you want to have a look at this yourself, I can have a look at it after you have committed your changes (running http://validator.w3.org/checklink is a good first step). +1 to commit. Regarding the disabled checks, are there configurations were they do us any good?
          Hide
          Bryan Pendleton added a comment -

          I successfully built and tested the updated FAQ. Attached is the revised
          faq.html as well as the patch-as-built, including the proposed change
          to forrest.properties to work around FOR-984.

          Please let me know how this looks.

          Show
          Bryan Pendleton added a comment - I successfully built and tested the updated FAQ. Attached is the revised faq.html as well as the patch-as-built, including the proposed change to forrest.properties to work around FOR-984 . Please let me know how this looks.
          Hide
          Bryan Pendleton added a comment -

          I encountered FOR-984 because my development machine runs JDK 1.6.
          Editing forrest.properties as follows seemed to work, following the suggestion
          in the FOR-984 description:

          -#forrest.validate.sitemap=$

          {forrest.validate}
          -#forrest.validate.stylesheets=${forrest.validate}

          +forrest.validate.sitemap=false
          +forrest.validate.stylesheets=false

          Show
          Bryan Pendleton added a comment - I encountered FOR-984 because my development machine runs JDK 1.6. Editing forrest.properties as follows seemed to work, following the suggestion in the FOR-984 description: -#forrest.validate.sitemap=$ {forrest.validate} -#forrest.validate.stylesheets=${forrest.validate} +forrest.validate.sitemap=false +forrest.validate.stylesheets=false
          Hide
          Bryan Pendleton added a comment -
          Show
          Bryan Pendleton added a comment - http://db.apache.org/derby/papers/derby_web.html has instructions...
          Hide
          Bryan Pendleton added a comment -

          I updated the XML source file, and am attaching the diff.

          I've never built the Derby site before, so now I'll need to learn how.

          I guess the first step is to try installing Forrest and see if 'forrest site' works?

          Show
          Bryan Pendleton added a comment - I updated the XML source file, and am attaching the diff. I've never built the Derby site before, so now I'll need to learn how. I guess the first step is to try installing Forrest and see if 'forrest site' works?

            People

            • Assignee:
              Bryan Pendleton
              Reporter:
              Kristian Waagan
            • Votes:
              0 Vote for this issue
              Watchers:
              0 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved:

                Development