Uploaded image for project: 'ActiveMQ Artemis'
  1. ActiveMQ Artemis
  2. ARTEMIS-476

Instructions for running examples are triplicated and confusing in one instance

    XMLWordPrintableJSON

Details

    • Bug
    • Status: Closed
    • Major
    • Resolution: Fixed
    • 1.3.0
    • 1.3.0
    • Broker
    • None

    Description

      Instructions for running examples are given in three different places

      1) File https://github.com/apache/activemq-artemis/blob/master/docs/user-manual/en/examples.md says

      2) README at https://github.com/apache/activemq-artemis/blob/master/README.md#examples says

      3) Another README at https://github.com/apache/activemq-artemis/blob/master/examples/README.md

      My qualms:

      Document 2 is the briefest of them all and quite honestly rather confusing. (the NB sentence at the end).

      Document 2 states, that `mvn verify` will run all examples, while both other documents say that to run all examples, one has to execute `mvn -Pexamples` verify. This is an inconsistency.

      Document 3 says that I need to set the -Xmx option only when I want to run all examples in a batch, with -Pexamples profile. I think that since each example is stopped before another is started, this advice is meaningless. What would make sense is to set this option before running any example, either single one or in batch. Document 1 does not mention -Xmx at all.

      Attachments

        Activity

          People

            jbertram Justin Bertram
            jdanek Jiri Daněk
            Votes:
            0 Vote for this issue
            Watchers:
            3 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved:

              Time Tracking

                Estimated:
                Original Estimate - 0.5h
                0.5h
                Remaining:
                Remaining Estimate - 0.5h
                0.5h
                Logged:
                Time Spent - Not Specified
                Not Specified