Derby
  1. Derby
  2. DERBY-5587

Due to licensing issues, fix or remove the monohtml docs posted on Derby's documentation page.

    Details

    • Type: Bug Bug
    • Status: Closed
    • Priority: Major Major
    • Resolution: Fixed
    • Affects Version/s: 10.9.1.0
    • Fix Version/s: 10.9.1.0
    • Component/s: Web Site
    • Labels:
      None
    • Urgency:
      Normal

      Description

      The monohtml versions of Derby's docs (from 10.3 onwards) need a legal notice. We should either add that notice to the monohtml docs or we should remove them from the Derby website. This issue is discussed in the following derby-dev email thread: http://old.nabble.com/Copyright-clairification-for-fo2html.xsl-in-Derby-software.-to33087407.html#a33087407

        Issue Links

          Activity

          Hide
          Myrna van Lunteren added a comment -

          I have been thinking about this, and looking on web sites, and it seems to me I have been misunderstanding the meaning of 'derived work'.
          From what I gather now from various web sites, including wikipedia, derived work means: "a new version of the original."

          Thus, the monohtml docs are not a derived work. They're the result of using the original. Thus, no notice is necessary.

          So, we don't need to remove them - at least not from old versions.

          Does this make sense?

          I think it is still a good idea to remove the file, and thus, to no longer build the monohtml going forward, because of the loopiness of not having permission to distribute the fo2html.xsl file and the requirement within Apache to distribute an src version with a release.

          But it seems to me this issue can be closed.

          Show
          Myrna van Lunteren added a comment - I have been thinking about this, and looking on web sites, and it seems to me I have been misunderstanding the meaning of 'derived work'. From what I gather now from various web sites, including wikipedia, derived work means: "a new version of the original." Thus, the monohtml docs are not a derived work. They're the result of using the original. Thus, no notice is necessary. So, we don't need to remove them - at least not from old versions. Does this make sense? I think it is still a good idea to remove the file, and thus, to no longer build the monohtml going forward, because of the loopiness of not having permission to distribute the fo2html.xsl file and the requirement within Apache to distribute an src version with a release. But it seems to me this issue can be closed.
          Hide
          Rick Hillegas added a comment -

          Hi Myrna,

          You may be right, but I am not a lawyer. In any event, I have reduced the urgency of this issue. As long as we address DERBY-5586 (removing the xsl script from the repository and disabling future generation of monohtml), then I do not see this issue being a blocker. Let's leave this issue open for a little while longer to let other people add their opinions. If no-one objects to your proposal, then I would be ok with closing this issue in a while. Thanks.

          Show
          Rick Hillegas added a comment - Hi Myrna, You may be right, but I am not a lawyer. In any event, I have reduced the urgency of this issue. As long as we address DERBY-5586 (removing the xsl script from the repository and disabling future generation of monohtml), then I do not see this issue being a blocker. Let's leave this issue open for a little while longer to let other people add their opinions. If no-one objects to your proposal, then I would be ok with closing this issue in a while. Thanks.
          Hide
          Kristian Waagan added a comment -

          Attaching patch 1a, which removes the HTML Book entries from the Derby documentation HTML page.

          I think this is ready for commit, but what's the conclusion on the appropriate action to take?
          Given that we have PDFs in addition to the HTML pages version, shall we err on the side of caution and remove the HTML Book version?

          Show
          Kristian Waagan added a comment - Attaching patch 1a, which removes the HTML Book entries from the Derby documentation HTML page. I think this is ready for commit, but what's the conclusion on the appropriate action to take? Given that we have PDFs in addition to the HTML pages version, shall we err on the side of caution and remove the HTML Book version?
          Hide
          Knut Anders Hatlen added a comment -

          +1 to removing the entries. I have no idea whether or not we are allowed to publish the old versions of the monohtml docs, or what the consequences are if we publish them without being allowed to do so, but I don't see that they provide enough value that having them on the website is worth the risk.

          If I read the patch correctly, it only removes the links, but the docs are still there. Are you planning to remove the actual docs as well in another patch?

          Show
          Knut Anders Hatlen added a comment - +1 to removing the entries. I have no idea whether or not we are allowed to publish the old versions of the monohtml docs, or what the consequences are if we publish them without being allowed to do so, but I don't see that they provide enough value that having them on the website is worth the risk. If I read the patch correctly, it only removes the links, but the docs are still there. Are you planning to remove the actual docs as well in another patch?
          Hide
          Rick Hillegas added a comment -

          IANAL but I agree with Knut's summary: the risk is real, and the value added by the monohtml versions is slight. +1 to removing the links and the monohtml docs themselves. Thanks.

          Show
          Rick Hillegas added a comment - IANAL but I agree with Knut's summary: the risk is real, and the value added by the monohtml versions is slight. +1 to removing the links and the monohtml docs themselves. Thanks.
          Hide
          Kim Haase added a comment -

          +1 to removing both.

          Show
          Kim Haase added a comment - +1 to removing both.
          Hide
          Kristian Waagan added a comment -

          Thanks for the feedback, people

          I've committed removal from the HTML file with revision 1328276, and I've updated the site.
          I'll let the HTML changes propagate first, and then drop the referenced files.

          As side matters, I think the manuals page changed for the worse now with links even further away from the titles/descriptions. That's however a different issue if anyone wants to pick it up...
          I also logged DERBY-5700, a small fix to the web site.

          Show
          Kristian Waagan added a comment - Thanks for the feedback, people I've committed removal from the HTML file with revision 1328276, and I've updated the site. I'll let the HTML changes propagate first, and then drop the referenced files. As side matters, I think the manuals page changed for the worse now with links even further away from the titles/descriptions. That's however a different issue if anyone wants to pick it up... I also logged DERBY-5700 , a small fix to the web site.
          Hide
          Kristian Waagan added a comment -

          I've deleted the monohtml manuals from the web site (the change should go live within a few hours).

          Show
          Kristian Waagan added a comment - I've deleted the monohtml manuals from the web site (the change should go live within a few hours).
          Hide
          Kim Haase added a comment -

          Thanks for the fixes, Kristian. The distance between the titles and links seems to be dependent on the width of my browser window, so it is not too serious a problem.

          Show
          Kim Haase added a comment - Thanks for the fixes, Kristian. The distance between the titles and links seems to be dependent on the width of my browser window, so it is not too serious a problem.
          Hide
          Rick Hillegas added a comment -

          Attaching derby-5587-02-aa-removeMonoHtmlFrom10.8ReleaseIndex.diff. This patch removes references to the monohtml books from the 10.8 top level index page. Committed to 10.8 branch at subversion revision 1405059.

          Touches the following files:

          M index.html

          Show
          Rick Hillegas added a comment - Attaching derby-5587-02-aa-removeMonoHtmlFrom10.8ReleaseIndex.diff. This patch removes references to the monohtml books from the 10.8 top level index page. Committed to 10.8 branch at subversion revision 1405059. Touches the following files: M index.html
          Hide
          Rick Hillegas added a comment - - edited

          Note that the references to monohtml books had already been removed from the trunk and 10.9 versions of index.html. It's worth checking 10.3, 10.4, 10.5, 10.6, and 10.7 to make sure that monohtml references have been removed from those branches too.

          Show
          Rick Hillegas added a comment - - edited Note that the references to monohtml books had already been removed from the trunk and 10.9 versions of index.html. It's worth checking 10.3, 10.4, 10.5, 10.6, and 10.7 to make sure that monohtml references have been removed from those branches too.
          Hide
          Rick Hillegas added a comment -

          Removed monohtml references from 10.7 index.html: subversion revision 1405065.

          Show
          Rick Hillegas added a comment - Removed monohtml references from 10.7 index.html: subversion revision 1405065.
          Hide
          Rick Hillegas added a comment -

          Removed monohtml references from 10.6 index.html: subversion revision 1405068.

          Show
          Rick Hillegas added a comment - Removed monohtml references from 10.6 index.html: subversion revision 1405068.
          Hide
          Rick Hillegas added a comment -

          Removed monohtml references from 10.5 index.html: subversion revision 1405069.

          Show
          Rick Hillegas added a comment - Removed monohtml references from 10.5 index.html: subversion revision 1405069.
          Hide
          Rick Hillegas added a comment -

          Removed monohtml references from 10.4 index.html: subversion revision 1405070.

          Show
          Rick Hillegas added a comment - Removed monohtml references from 10.4 index.html: subversion revision 1405070.
          Hide
          Rick Hillegas added a comment -

          Removed monohtml references from 10.3 index.html: subversion revision 1405071.

          Show
          Rick Hillegas added a comment - Removed monohtml references from 10.3 index.html: subversion revision 1405071.

            People

            • Assignee:
              Kristian Waagan
              Reporter:
              Rick Hillegas
            • Votes:
              0 Vote for this issue
              Watchers:
              1 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved:

                Development