You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@whirr.apache.org by "Andrei Savu (JIRA)" <ji...@apache.org> on 2011/05/18 09:50:49 UTC

[jira] [Created] (WHIRR-310) Improve Configuration Guide

Improve Configuration Guide
---------------------------

                 Key: WHIRR-310
                 URL: https://issues.apache.org/jira/browse/WHIRR-310
             Project: Whirr
          Issue Type: Improvement
          Components: documentation
    Affects Versions: 0.5.0
            Reporter: Andrei Savu
            Assignee: Andrei Savu
             Fix For: 0.5.0


Many configuration options are missing from the configuration guide. We should address this before releasing 0.5.0 in order to minimize the user frustration. 

--
This message is automatically generated by JIRA.
For more information on JIRA, see: http://www.atlassian.com/software/jira

[jira] [Updated] (WHIRR-310) Improve Configuration Guide

Posted by "Andrei Savu (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/WHIRR-310?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Andrei Savu updated WHIRR-310:
------------------------------

    Attachment: WHIRR-310.patch

In this patch:
* split the configuration options in multiple groups that are easier to understand
* checked that all configuration options are documented
* minor style updates for homepage (whirr & incubator logo)
* moved the "whirr in 5 minutes" guide to home page (it's small enough and it should allow users to understand easily what Whirr can do)
* fixed outdated FAQ entries
* warning message explaining how Whirr is tested

I believe we should also commit this patch to the 0.5.0 branch. 

> Improve Configuration Guide
> ---------------------------
>
>                 Key: WHIRR-310
>                 URL: https://issues.apache.org/jira/browse/WHIRR-310
>             Project: Whirr
>          Issue Type: Improvement
>          Components: documentation
>    Affects Versions: 0.5.0
>            Reporter: Andrei Savu
>            Assignee: Andrei Savu
>             Fix For: 0.5.0
>
>         Attachments: WHIRR-310.patch
>
>
> Many configuration options are missing from the configuration guide. We should address this before releasing 0.5.0 in order to minimize the user frustration. 

--
This message is automatically generated by JIRA.
For more information on JIRA, see: http://www.atlassian.com/software/jira

[jira] [Updated] (WHIRR-310) Improve Configuration Guide

Posted by "Tom White (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/WHIRR-310?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Tom White updated WHIRR-310:
----------------------------

    Resolution: Fixed
        Status: Resolved  (was: Patch Available)

I've just committed this. Thanks, Andrei!

> Improve Configuration Guide
> ---------------------------
>
>                 Key: WHIRR-310
>                 URL: https://issues.apache.org/jira/browse/WHIRR-310
>             Project: Whirr
>          Issue Type: Improvement
>          Components: documentation
>    Affects Versions: 0.5.0
>            Reporter: Andrei Savu
>            Assignee: Andrei Savu
>             Fix For: 0.5.0
>
>         Attachments: WHIRR-310-0.5.0-standalone-page.patch, WHIRR-310-0.5.0.patch, WHIRR-310-standalone-page.patch, WHIRR-310.patch
>
>
> Many configuration options are missing from the configuration guide. We should address this before releasing 0.5.0 in order to minimize the user frustration. 

--
This message is automatically generated by JIRA.
For more information on JIRA, see: http://www.atlassian.com/software/jira

[jira] [Commented] (WHIRR-310) Improve Configuration Guide

Posted by "Andrei Savu (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/WHIRR-310?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13036759#comment-13036759 ] 

Andrei Savu commented on WHIRR-310:
-----------------------------------

I moved the "Whirr in 5 minutes guide" to the About / Home page so that more users could see it. I guess this is more like a matter of personal taste so I will attach a new patch and let you choose. 

> Improve Configuration Guide
> ---------------------------
>
>                 Key: WHIRR-310
>                 URL: https://issues.apache.org/jira/browse/WHIRR-310
>             Project: Whirr
>          Issue Type: Improvement
>          Components: documentation
>    Affects Versions: 0.5.0
>            Reporter: Andrei Savu
>            Assignee: Andrei Savu
>             Fix For: 0.5.0
>
>         Attachments: WHIRR-310.patch
>
>
> Many configuration options are missing from the configuration guide. We should address this before releasing 0.5.0 in order to minimize the user frustration. 

--
This message is automatically generated by JIRA.
For more information on JIRA, see: http://www.atlassian.com/software/jira

[jira] [Commented] (WHIRR-310) Improve Configuration Guide

Posted by "Tom White (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/WHIRR-310?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13036675#comment-13036675 ] 

Tom White commented on WHIRR-310:
---------------------------------

This looks great. The only thing I wouldn't change is the "whirr in 5 minutes guide". I think it's very useful having it on its own page as users look at the naviagation and see that heading. Burying it in "About" means fewer people will find it. We should prominently link to it from the About page though.

I agree this change should go in 0.5.0.

> Improve Configuration Guide
> ---------------------------
>
>                 Key: WHIRR-310
>                 URL: https://issues.apache.org/jira/browse/WHIRR-310
>             Project: Whirr
>          Issue Type: Improvement
>          Components: documentation
>    Affects Versions: 0.5.0
>            Reporter: Andrei Savu
>            Assignee: Andrei Savu
>             Fix For: 0.5.0
>
>         Attachments: WHIRR-310.patch
>
>
> Many configuration options are missing from the configuration guide. We should address this before releasing 0.5.0 in order to minimize the user frustration. 

--
This message is automatically generated by JIRA.
For more information on JIRA, see: http://www.atlassian.com/software/jira

[jira] [Updated] (WHIRR-310) Improve Configuration Guide

Posted by "Andrei Savu (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/WHIRR-310?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Andrei Savu updated WHIRR-310:
------------------------------

    Status: Patch Available  (was: Open)

> Improve Configuration Guide
> ---------------------------
>
>                 Key: WHIRR-310
>                 URL: https://issues.apache.org/jira/browse/WHIRR-310
>             Project: Whirr
>          Issue Type: Improvement
>          Components: documentation
>    Affects Versions: 0.5.0
>            Reporter: Andrei Savu
>            Assignee: Andrei Savu
>             Fix For: 0.5.0
>
>         Attachments: WHIRR-310.patch
>
>
> Many configuration options are missing from the configuration guide. We should address this before releasing 0.5.0 in order to minimize the user frustration. 

--
This message is automatically generated by JIRA.
For more information on JIRA, see: http://www.atlassian.com/software/jira

[jira] [Updated] (WHIRR-310) Improve Configuration Guide

Posted by "Andrei Savu (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/WHIRR-310?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Andrei Savu updated WHIRR-310:
------------------------------

    Attachment: WHIRR-310-standalone-page.patch
                WHIRR-310-0.5.0-standalone-page.patch
                WHIRR-310-0.5.0.patch

I've created patches for the 0.5.0 branches. 

I still believe the "Whirr in 5 minutes guide" should be on the homepage. :)

> Improve Configuration Guide
> ---------------------------
>
>                 Key: WHIRR-310
>                 URL: https://issues.apache.org/jira/browse/WHIRR-310
>             Project: Whirr
>          Issue Type: Improvement
>          Components: documentation
>    Affects Versions: 0.5.0
>            Reporter: Andrei Savu
>            Assignee: Andrei Savu
>             Fix For: 0.5.0
>
>         Attachments: WHIRR-310-0.5.0-standalone-page.patch, WHIRR-310-0.5.0.patch, WHIRR-310-standalone-page.patch, WHIRR-310.patch
>
>
> Many configuration options are missing from the configuration guide. We should address this before releasing 0.5.0 in order to minimize the user frustration. 

--
This message is automatically generated by JIRA.
For more information on JIRA, see: http://www.atlassian.com/software/jira