[DOCU-2393] DOC: Collecting first-time customer feedback for installation of Maven & Maven Magnolia settings Created: 07/Feb/22  Updated: 19/Oct/22  Resolved: 19/Oct/22

Status: Closed
Project: Documentation
Component/s: None
Affects Version/s: None
Fix Version/s: None

Type: Task Priority: Neutral
Reporter: Adrian Brooks Assignee: Adrian Brooks
Resolution: Done Votes: 0
Labels: authx
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Template:
Acceptance criteria:
[ ]* First-time customer feedback for Step 1 above added to this ticket as a comment
Task DoR:
Empty

 Description   

dmaslanka will follow documentation instructions as if he were a first-time customer and provide feedback on his user experience for step 1 below.

Step 1
-------
Goal: Install Maven and configure the Magnolia Maven settings
How to: Follow the respective links to instructions in the requirements section on this page: https://docs.magnolia-cms.com/product-docs/6.2/Developing/Bundles-and-webapps/Creating-a-custom-webapp-with-Maven.html

 

The goal is to use his feedback to create a new "Quick start guide for custom DX core webapps" (an epic will be created for this, and I will add further tasks to collect feedback over the next weeks).

In general, the new quick start guide should include minimal explanation (essentially a list of commands or cheat sheet format). Initial ideas were:

  1. Install JDK (note version 8)
  2. Install Maven (note Windows version restriction)
  3. Configure password encryption <command>
  4. Get DX Core project settings <command>
  5. Create folder for webapp
  6. Generate archetype <command> <interaction details>
  7. Copy over POM to [...location...] <finished POM file>
  8. ...

so we would duplicate the existing tutorial (https://docs.magnolia-cms.com/product-docs/6.2/Developing/Bundles-and-webapps/Creating-a-custom-webapp-with-Maven/Creating-a-DX-Core-webapp-with-Maven.html) and try to shorten it by: * Bringing some of the credentials content over into ascidoc



 Comments   
Comment by Adrian Brooks [ 19/Oct/22 ]

Marking this as done for the time-being because of a spate of recent improvement tickets for first-time users: DOCU-2567, DOCU-2571, DOCU-2569, and DOCU-2393. But keeping it in mind for a possible reopen if the installation topic comes up again.

Generated at Mon Feb 12 01:26:44 CET 2024 using Jira 9.4.2#940002-sha1:46d1a51de284217efdcb32434eab47a99af2938b.