On 8/20/07, Max Hofer <[EMAIL PROTECTED]> wrote: > On Friday 17 August 2007, matilda matilda wrote: > > Hi all, > > > > it's not a secret that the documentation of HAv2 is not the best. > > > > As some guys here on the list were very helpful to me the last > > days/weeks (especially Andrew, Lars, Max, Eddie) I would like to > > add some documentation/snippets. > > > > So, I really don't know where to start. The structure of the > > current site is not visible to me. Is there a new substructure > > in the wiki where I could start? I don't want to make massive > > changes at the start and probably affronting someone. > > > > A nucleus was introduced by the www.linux-ha.org/Education page > > but nothing seemed to happen afterwards. > > > > Another problem is, that meanwhile there are so many versions of > > HA which are subtle different and can bite you badly. So some > > aspects in the documentation have to be tagged with a version. > > > > Any ideas? Recommendations? > > > > Or shall I start as Nero did? :-)) > Hi all, > > I'm back from vacation ;-) > > I currently work on a manual "Dive into Linux HA 2" (or "An Introduction to > Linux HA 2" - not sure about the title yet). > > Intention: shows how to work with heartbeat from command line by examples; all > heartbeat concepts are shown with reproducible examples using Dummy and Delay > resource agent - no special hardware is needed. > > What it does not contain: how to design a cluster; working with the GUI (which > is IMHO not ready to use for production); real life cluster examples; > > Taret Group: newbies/novice/journeyman sysadmins > > Language: english > > Heartbeat Release: as of version 2.1.0 and upwards (with some references back > to older versions like 2.0.8 - where they behave differently) > > Source Format: DocBook (I still struggle with layouts etc.) > > Current State: a PDF version is currently 30 pages long containing 20% of the > content I would like to put in ---> I intended to write an article but it > starts to become a book. > > Time Schedule: since my GF is on vacation (and thus I can fully work on it > during my free time) I hope I get a first draft version ready for revision by > mid/end September > > Problem: I need an OK from by Boss that I can release the document under a > free License (I spoke with him today and it seems there should not be a > problem) - I created the document in my free time but the knowledge I got > mainly during work time. > > Main Problem: > * someone from the developers has to review it because I would not like to > give out false information > * english is not my first languge (actually I never had it in school) - I need > people who review the document > * if someone worked with DocBook I would be glad for help with Stylsheets for > PDF and HTML versions of the doucment > > If enough people are intersted to help out I could setup a mercurial repo (I > have no server but I'm sure we will find one) for sharing the document - > (after I cleared the License issues).
oddly enough i was just thinking about this... the novell documentation is also in docbook format and i was considering creating a public Hg repo from it so people could submit changes (since some people prefer more structure than a wiki provides) the part I hadn't figured out is how, where and how often we make the changes available (going through the novell doc team is one option but I'm open to suggestions) does that sound like something people would contribute to? Max: would you prefer to keep your document separate or would you consider integrating them? _______________________________________________ Linux-HA mailing list [email protected] http://lists.linux-ha.org/mailman/listinfo/linux-ha See also: http://linux-ha.org/ReportingProblems
