brooklyn-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "ASF GitHub Bot (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (BROOKLYN-55) Documentation for a server install
Date Tue, 09 Sep 2014 15:41:28 GMT

    [ https://issues.apache.org/jira/browse/BROOKLYN-55?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14127121#comment-14127121
] 

ASF GitHub Bot commented on BROOKLYN-55:
----------------------------------------

Github user richardcloudsoft commented on the pull request:

    https://github.com/apache/incubator-brooklyn-site/pull/6#issuecomment-54989293
  
    Thanks for the PR Andrea - sorry that I have had to make quite a few comments on it. It
seems to be performing several different changes - changing the nav categories, renaming pages,
adding content - that should have been split into different commits. It also seems to be going
beyond the scope of BROOKLYN-55 which was to add details of server installation, so I think
that the changes unrelated to BROOKLYN-55 should have been in a different PR.
    
    Specifically regarding BROOKLYN-55, I don't think that the content changes have fully
addressed the bug report. A server installation is different to a desktop installation (and
the desktop installation should be satisfactorily described [on the current site](https://brooklyn.incubator.apache.org/quickstart/index.html))
and that page needs to cover things like making sure that the install is remotely and securely
accessible, and how to start Brooklyn in such a way that it doesn't terminate when you log
out of the server.
    
    I would suggest that you re-visit the server install page content, and add it as a child
of the "documentation" navigation group.
    
    The other changes you made to the navigation and them home page can certainly be considered
- they are *not* sacred! - but they need to be justified and I would not merge them until
they have been reviewed by at least two people. Adding content, however, is a much simpler
review process, and it can be reviewed and published to the website in little time, which
is why I strongly recommend that the changes are separated.


> Documentation for a server install
> ----------------------------------
>
>                 Key: BROOKLYN-55
>                 URL: https://issues.apache.org/jira/browse/BROOKLYN-55
>             Project: Brooklyn
>          Issue Type: Sub-task
>    Affects Versions: 0.7.0-M1
>            Reporter: Richard Downer
>            Assignee: Andrea Turli
>             Fix For: 0.7.0
>
>
> Document how to install Brooklyn onto a server (not onto a local workstation) - include
typical considerations such as where to install files, remote access, automatic startup.



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

Mime
View raw message