Provides a blue print for idea capture, search, and display.

The latest released version can be downloaded from github.

The plugin is built using the Atlassian SDK, for installation instructions see Atlassian documentation.

Either add the addon through the Atlassian Market place (link to come) or by directly installing the .jar file from one of the releases

1. Clone the repository
2. Install the Atlassian SDK
3. In the root directory run atlas-run to start the confluence server
4. Once Confluence has started you can access it via http://localhost:1990/confluence. Note you will need to change the baseUrl in the confluence settings otherwise you will have issues with the creation of resources

• To run without tests add this argument to the command -Dmaven.test.skip=true
• We suggest dumping logs to a file due to the large number of lines in the output. A command to do this would be rm -rf logs.log; atlas-run > logs.log

To run the hot reload, have the confluence server running. Run the command atlas-mvn package which will build the app. The server will see the change and hot load the new version into the app.

The following tools are required/recommended to develop with this repository

• Atlassian sdk: https://developer.atlassian.com/server/framework/atlassian-sdk/
• Yarn: https://classic.yarnpkg.com/en/docs/install
• Prettier: https://prettier.io/docs/en/install.html
• Nvm: https://github.com/nvm-sh/nvm#installing-and-updating
• Plugin integration test fixture: https://developer.atlassian.com/server/framework/atlassian-sdk/create-test-data-and-a-test-fixture/

Integration testing data can be generated, modified and stored in a test instance. This makes creating integration test fixtures much quicker and easier and is fully integrated with Atlassian sdk.

Run integration tests by suppling test data path in the following command. Currently the data is stored in src/test/resources
atlas-integration-test -Dtest.integration.path=pathToTestData

To utilise current test fixture and modify test data:

1. To see and explore existing test instance, start in debug mode atlas-debug
2. Currently in the test instance, there is a test page with four technologies: "java", "js", "python", "ts"
3. Navigate around confluence and create test data by interacting with the test instance.
4. Close the server and clean existing instance atlas-clean
5. Start again in debug mode. You should now see your test data in the instance.

To create a new test fixture:

1. Run an instance and interact with confluence to create test data. atlas-run -DskipTests=true
2. Create a zip of the application home directory in target. atlas-create-home-zip
3. Copy the test resources to plugin home directory. cp target/confluence/generated-test-resources.zip PLUGIN_HOME/src/test/resources

PR are welcomed

This repository is using semantic release, therefore the commit messages should follow the angular guidelines or another guide .

Branches should be attached either to an issue in this repository, or a ticket on the jira,

Please name the branch type/issueNumber/description

where type is either;

• feat
• fix
• chore
• docs
• etc from the semvar naming strategy

For example: feat/issue3/add-idea-blueprint

Please name the branch type/ticketNumber/description

where type is either;

• feat
• fix
• chore
• docs
• etc from the semvar naming strategy

For example: feat/ADE-101/add-idea-blueprint

Your Branch => develop => qa => master

Please do the following before creating a PR;

• have an issue or a jira ticket,
• write a descriptive PR title
• Add the @agiledigital-labs/atlassian-plugin team as a reviewer
• We will review and provide feedback as soon as we can, it is easier if you help us along

We are supporting versions from 7.6.2 onwards at this stage, if there are any issues please raise an issue on this repo