Issue Details (XML | Word | Printable)

Key: CONF-8683
Type: Improvement Improvement
Status: Closed Closed
Resolution: Fixed
Priority: Major Major
Assignee: Sarah Maddox [Atlassian]
Reporter: Matt Ryall [Atlassian]
Votes: 0
Watchers: 0
Operations

Add/Edit UI Mockup to this issue
If you were logged in you would be able to see more operations.
Confluence

Separate standalone installation guide for each operating system

Created: 11/Jun/07 09:11 PM   Updated: 16/Mar/08 08:13 PM   Resolved: 16/Mar/08 08:13 PM
Component/s: Documentation
Affects Version/s: None
Fix Version/s: None

Time Tracking:
Not Specified

Issue Links:
Reference
 

Participants: Matt Ryall [Atlassian] and Sarah Maddox [Atlassian]
Since last comment: 1 year, 51 weeks, 2 days ago
Labels:


 Description  « Hide

Combining the standalone installation guide into one page has benefits for maintainability, but it's pretty tricky when you need to add instructions which are specific to a particular OS.

Specifically, I'd like to see the following changes for the Mac:

  • screenshot of installation: extracting the ZIP and copying it to a sensible location
  • instructions for how to run startup.sh after opening a Terminal window, rather than double-clicking on it
  • Mac-specific instructions for setting the home directory in confluence-init.properties
  • links to Mac-related guides, like making Confluence start up automatically on the server or setting JAVA_HOME in your profile.

At the moment, we have various sentences like "If you're running Windows do X", and "If you're on a Mac do Y". These could be eliminated, and all the documents would be much shorter.

The stages breakdown we apply to Windows also isn't appropriate to the Mac. For example, we skip the first stage on a Mac. I think some of the initial steps are easier and can be merged together, whereas the final stage of starting the application from a Terminal is actually the most complex step.



Sarah Maddox [Atlassian] added a comment - 16/Mar/08 08:13 PM

I'm marking this issue as fixed, because the docs have been extensively revised for Confluence 2.5 (http://jira.atlassian.com/browse/CONF-10762) and the related request (http://jira.atlassian.com/browse/CONF-10357).

Request for review is at http://jira.atlassian.com/browse/CONF-11130