Posted by muschpusch on May 19, 2012 at 5:03pm
I think omega8cc did an amazing job creating BOA and the response time in the issue queue is blazing fast. The only thing missing is good documentation. At the moment i push every little piece of knowledge i get to the community wiki page. http://groups.drupal.org/node/163784
I would like to ask people to join me and think about a more structured documentation than this one page only :)
The most obvious way to do it would be splitting up the docs for barracuda / octopus and move it to drupal.org
Barracuda
pages for: firewall / nginx / php / mysql etc. all this more or less sysadmin stuff.
Octopus
more developer oriented / Aegir / development best practices / etc
What do you think?
Comments
i think it is a good idea,
i think it is a good idea, and i want to join you in this project.
Roman
https://drupal-admin.com
nice! I think we can often
nice! I think we can often relate to existing documentation (like aegir docs) so that we don't duplicate to much.
Great Idea
There's lots of good information out there, but it's split up a lot across different sources. Having a more centralized location would help with finding answers as well as keeping everything up-to-date.
Ok how should we start? Is
Ok how should we start? Is there a boa irc channel to meet? Otherwise that would be a nice start :)
We have #omega8cc channel for
We have #omega8cc channel for BOA related community support on irc.freenode.net
Thanks!
New place for BOA documentation and FAQ at drupal.org
muschpusch wrote:
At drupal.org, I've just started a short, initial stub under Distribution documentation > Aegir hosting system > Barracuda and Octopus: Aegir and Drupal distributions installers (BOA), that we can use to share community documentation, to collect questions and answers as FAQ, etc.
this MS Word doc useful to you?
I collected my notes on my Drupal BOA work so far in a Microsoft Word doc. Download it from this page on my wiki.
http://wiki.internetmachines.co.uk/mediawiki/index.php?title=BOA
I've been meaning to
* get the Omega8 guys to check it, then
* translate it to a wiki,
but maybe you can do something with it now.
How will I know if this BOA doc was worth the work? I hope it will be useful to people, but it is impossible to say which bits work and which bits don't. I am too close to the words. If you have any constructive criticism - complete awesomeness, I wouldn't wipe my bum on it, whatever - please let me know.
MS Word -> Open Format
Thank you for sharing your notes!
I see you are planning to move it to a wiki. Maybe in the meantime you can make it an open format like ODF (LibreOffice) or even RTF?
now there's im-boa.odt
OK, done
http://wiki.internetmachines.co.uk/mediawiki/images/3/32/Im-boa.odt
BOA book
Thank you very much for writing your 191 pages book on BOA.
Thank you very much and a happy New Year !!!
This is great exactly what I was looking for ! Best regards Arthur from Amsterdam !
1,000 views but no feedback
Help! This document is turning into the blob, consuming everything in its path and growing huge.
Am I going in the right direction?
Any honest feedback is welcome.
Many thanks, guys.
Wow , that's nice! Excellent
Wow , that's nice! Excellent doc :)
After all Santa exists!
Thank you for the great doc. I'll have something to dig during the next few days.
I added some of the wiki
I added some of the wiki stuff to the drupal.org docs. I'm not sure in how far we should try to add documentation to the different components of BOA since we would duplicate existing documentation of the projects, so i would propose to just add some links and create a FAQ. One thing which is in urgent need is some documentation of the xdrago scripts which run on cron. Those aren't documented at all.
GIT option in Barracuda
Has anyone documented the GIT service in barracuda and how it all works etc?