Documentation; GO!

[Paulo Ribeiro]

I also thought about automatizing the process of copying the current 
documentation to the wiki (for example, using regular expressions to 
convert HTML into wiki syntax), but I also think it is not very 
straightforward because the two syntaxes are not equivalent.

I think that if we had the entire documentation in the wiki it would be 
easier to propose macro level changes to the documentation (such as 
changes in the structure of the topics, organization of information, and 
so on).

I'm not sure how many people are interested in participating on this 
project, but if each person would copy a small subset of the 
documentation topics to the wiki then we could have a collaborative 
platform ready in a very short time.

-- 
Paulo Ribeiro

On 12.08.02 18:59, Elizabeth Krumbach wrote:
> On Thu, Aug 2, 2012 at 4:03 AM, Paulo Ribeiro <paulo at diffraction.pt> wrote:
>> The first task of copying the documentation to the wiki seems practical and
>> simple enough. I will be sure to help with that as time allows.
>
> I tried to use some scripts to convert both docbook and html to wiki
> syntax and it wasn't as straight forward as I had hoped. Before
> spending too much time on this I would recommend coming up with a
> methodology for what to copy over. Does a page look good and not need
> updating? Maybe not copy that one over. Or maybe just copy over
> sections you intend to work on?
>
> It's also worth noting that while I set up the wiki, we don't have to
> use it if people find it too cumbersome. If someone has better ideas
> for how to collaborate on this or wants different software installed
> that's perfectly fine (the server is running Debian 6.0). I can even
> give folks shell accounts if you'd rather work directly with flat
> html. All up to you.
>
> Thanks.
>