Uploaded image for project: 'IGB'
  1. IGB
  2. IGBF-3803

IGB Readme should state that building IGB requires JavaFX

    Details

    • Type: Task
    • Status: Closed (View Workflow)
    • Priority: Major
    • Resolution: Done
    • Affects Version/s: None
    • Fix Version/s: None
    • Labels:
      None

      Description

      One of the reviewers of our 2024 BOSC abstract tried to build IGB but could not do it because they did not realize that they needed to use a JDK that includes JavaFX.

      We need to make sure that the Readme makes this clear. In addition to stating that developers need to build IGB using JDK21 (our preferred JDK) we also need to tell them that the JDK they use needs to include JavaFX.

      We could also recommend the JDK that we are using internally for building and deploying IGB.

      I'm putting this in the current sprint so that we can get this done before I give the talk at the 2024 BOSC meeting in two weeks.

        Attachments

          Activity

          Hide
          ann.loraine Ann Loraine added a comment - - edited

          I re-wrote the IGB README.md file.

          I would be grateful if someone could read it and offer feedback. Is it good enough?

          See:

          Show
          ann.loraine Ann Loraine added a comment - - edited I re-wrote the IGB README.md file. I would be grateful if someone could read it and offer feedback. Is it good enough? See: https://bitbucket.org/lorainelab/integrated-genome-browser/src/main/
          Hide
          nfreese Nowlan Freese added a comment -

          Reviewed the readme. Only two edits I would make:

          I'm not sure how much specific information about the JDK we would need for someone to build IGB. I think an experienced developer would be able to figure it out based on the way it is written. A less experienced developer may need more information, but I'm not sure the readme would be the right place. Sravani did create a developers guide page on how to get IGB running in IntelliJ based on feedback from Dylan: https://wiki.bioviz.org/confluence/display/igbdevelopers/Setup+IntelliJ+for+IGB+development+with+Java+21

          Show
          nfreese Nowlan Freese added a comment - Reviewed the readme. Only two edits I would make: Change the YouTube link to the branded link: https://www.youtube.com/c/IntegratedGenomeBrowser Typo in the line: Visit the Branches section of your repsitory and right-click the branch you want to build. I'm not sure how much specific information about the JDK we would need for someone to build IGB. I think an experienced developer would be able to figure it out based on the way it is written. A less experienced developer may need more information, but I'm not sure the readme would be the right place. Sravani did create a developers guide page on how to get IGB running in IntelliJ based on feedback from Dylan: https://wiki.bioviz.org/confluence/display/igbdevelopers/Setup+IntelliJ+for+IGB+development+with+Java+21
          Show
          nfreese Nowlan Freese added a comment - PR: https://bitbucket.org/lorainelab/integrated-genome-browser/pull-requests/1028/overview
          Hide
          ann.loraine Ann Loraine added a comment -

          PR is merged. Ready for testing.

          Show
          ann.loraine Ann Loraine added a comment - PR is merged. Ready for testing.

            People

            • Assignee:
              ann.loraine Ann Loraine
              Reporter:
              ann.loraine Ann Loraine
            • Votes:
              0 Vote for this issue
              Watchers:
              2 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved: