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. asBuilt.diff
        18 kB
        Bryan Pendleton
      2. faq.html
        35 kB
        Bryan Pendleton
      3. fixSearchFAQ.diff
        18 kB
        Bryan Pendleton
      4. xml.diff
        6 kB
        Bryan Pendleton

        Issue Links

          Activity

          Kristian Waagan created issue -
          Bryan Pendleton made changes -
          Field Original Value New Value
          Assignee Bryan Pendleton [ bryanpendleton ]
          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?
          Bryan Pendleton made changes -
          Attachment xml.diff [ 12423777 ]
          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 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 -

          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.
          Bryan Pendleton made changes -
          Attachment faq.html [ 12423779 ]
          Attachment asBuilt.diff [ 12423780 ]
          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 -

          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.
          Bryan Pendleton made changes -
          Attachment fixSearchFAQ.diff [ 12423885 ]
          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 -

          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
          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 -

          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.
          Bryan Pendleton made changes -
          Status Open [ 1 ] Resolved [ 5 ]
          Fix Version/s 10.6.0.0 [ 12313727 ]
          Resolution Fixed [ 1 ]
          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!
          Kristian Waagan made changes -
          Status Resolved [ 5 ] Closed [ 6 ]
          Kristian Waagan made changes -
          Link This issue relates to DERBY-4434 [ DERBY-4434 ]
          Gavin made changes -
          Workflow jira [ 12463791 ] Default workflow, editable Closed status [ 12799487 ]

            People

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

              Dates

              • Created:
                Updated:
                Resolved:

                Development