[Box Backup] Documentation writing tools (was: ExcludeFile command being ignored with Win32 client.)

Ben Summers boxbackup@fluffy.co.uk
Fri, 11 Aug 2006 09:46:52 +0100


On 11 Aug 2006, at 01:20, Per Thomsen wrote:

> On 8/10/06 1:57 PM, E.W. Peter Jalajas wrote:
>> Yes, Per has done wonderful work!  A few months ago though, I  
>> tried, I
>> swear, but I was too lazy and not smart enough to install and  
>> learn the
>> couple of different development and xml related tools needed to
>> contribute (I think I recall that I had package dependency  
>> conflicts),
>> so I just stuck with the wiki.
>> Per, could you please point me to the instructions on how to get
>> started (again) and I'll give a second try?  What dev (svn?) and xml
>> tools to use, how to checkout/checkin the pages, coding and character
>> set goals/standards, etc.
>>
> The instructions are on the Wiki: http://boxbackup.hostworks.ca/ 
> index.php/DocProject
>
> Briefly: Documents are created in DocBook, using XMLMinds free  
> (beer) version of XXE, and checked into SVN. A baseline of docs  
> (mostly gathered from the Wiki) have been created, but some of the  
> books could do with some TLC.
>
> To make the documents from the DocBook sources, xsltproc is needed.


XML isn't too difficult to write by hand. Is it sensible to try  
editing them by hand and getting someone else to check they validate  
properly?

I'm just wondering how the barrier to participation can be reduced.

Ben