http://crowbar.github.io/docs/build-crowbar.html

Simon Jakesch
Crowbar Product and Community Manager
Dell | Enterprise Cloud Solutions
mobile +1 303 807 9537, skype magurer1
simon_jake...@dell.com


-----Original Message-----
From: Pittaro, Michael 
Sent: Friday, July 19, 2013 2:46 PM
To: Jakesch, Simon; aspi...@suse.com; crowbar
Subject: RE: [Crowbar] Trello for Resolving Community Documentation Issues 
(Help request!)

Which build documentation ?  We have six places right now ...

https://trello.com/b/8bXdPOeN/community-documentation-issues

-----Original Message-----
From: crowbar-bounces On Behalf Of Jakesch, Simon
Sent: Friday, July 19, 2013 12:00 PM
To: aspi...@suse.com; crowbar
Subject: Re: [Crowbar] Trello for Resolving Community Documentation Issues 
(Help request!)

FYI,

I've revised the build instructions, I intend on tackling the Getting Started 
Guide next.

Simon


-----Original Message-----
From: crowbar-bounces On Behalf Of Adam Spiers
Sent: Friday, July 19, 2013 12:13 PM
To: crowbar
Subject: Re: [Crowbar] Trello for Resolving Community Documentation Issues 
(Help request!)

Rob Hirschfeld (rob_hirschf...@dell.com) wrote:
> Adam,
> 
> I agree on the concern about too many Trello's.  Right now the 2.0 
> Backlog is not being managed.

Ah I see, is there a plan for when to start managing it again?

> My concern would be that people would not add 1.x doc issues to that backlog.

Well, there is also a 1.6 backlog board :-)

> I'm open to suggestions!

It's probably not so important to worry about which board these cards should 
live on - the main thing is to actually address them.  The main problems right 
now are a) that most of the doc tasks are unassigned and/or completely 
neglected, and b) the documentation is utterly bewildering for newcomers ;-/

We need to prioritise fixing the first documentation which a newcomer to 
Crowbar first encounters or would like to encounter, since the main objective 
is to grow the community.  The first port of call is most likely 
http://crowbar.github.io/ and I guess most people are likely to click on the 
Find Out More button first which leads to:

    http://crowbar.github.io/docs/getting-started/

Unfortunately AFAICS that page is currently useless, since it doesn't provide 
any download links.  The first item listed is "Configuring the Network" - 
hardly appropriate for the beginning of a quickstart guide!
Even the 3rd item "Installing Crowbar" doesn't explain how to install Crowbar.  
Whilst glaring gaps such as these remain, I can't imagine the Crowbar community 
ever growing :-/  So yes, a Docs Hack Day is much needed.

Thanks for being open to this discussion!!

_______________________________________________
Crowbar mailing list
Crowbar@dell.com
https://lists.us.dell.com/mailman/listinfo/crowbar
For more information: http://crowbar.github.com/

_______________________________________________
Crowbar mailing list
Crowbar@dell.com
https://lists.us.dell.com/mailman/listinfo/crowbar
For more information: http://crowbar.github.com/

_______________________________________________
Crowbar mailing list
Crowbar@dell.com
https://lists.us.dell.com/mailman/listinfo/crowbar
For more information: http://crowbar.github.com/

Reply via email to