[bind10-dev] Documentation - inplace vs wiki

[Stephen Morris]

On 13 Dec 2010, at 16:44, Jeremy C. Reed wrote:

>> What do you think? Does it make sense? Do we want to talk this over on 
>> the F2F?
> 
> Yes, I'd like to talk about this at the meeting.
> 
> My preference is to keep in the source tree. But the existing formatting 
> of our doxygen and python docs are not greatly useful to me. I'd like to 
> see if you have any examples of ideas of generating design docs and 
> images.

My thought was to use OpenOffice to write the documents, which should mean that everyone can read them.

However, as PDFs are probably a more widely-readable document format, we could always generate PDFs with some form of command-line tool (e.g. see http://stackoverflow.com/questions/355447/openoffice-command-line-pdf-creation) and include them in the distribution.

Stephen