← Back to team overview

ooc-dev team mailing list archive

Re: Our documentation system

 

Yup, I agree. Personally I think wandernauta's herdscribe was more geared
towards documentation than beutdeuce's explain was. I think explain is great
for learning, but not suitable for reference docs, probably.

Also, Nilium, what did you come up with? You seemed pretty voicy in the
debate, and - truth be told - what you do is generally pretty, so I was
looking forward to seeing some progress on this front.

Love, n' - from the Seattle-Tacoma airport - ddrylliog.

On Fri, Jul 23, 2010 at 4:45 PM, Friedrich Weber <
fred.reichbier@xxxxxxxxxxxxxx> wrote:

> (pushing this a bit :D)
>
> Alright, so it seems like we agree on using Markdown for inline
> documentation (oocdocs) and for handwritten documentation. I think we need
> to make clear if pandoc can handle the needed inter-doc links or if we have
> to hack our modifications into it.
>
> Also, both beutdeuce's explain backend and wandernauta's herdscribe look
> like good bases. We just have to agree on one.
>
> And also, who would take responsibility over the documentation
> (implementation) part? :)
>
> Greetings,
>
>
> Friedrich
>
> _______________________________________________
> Mailing list: https://launchpad.net/~ooc-dev
> Post to     : ooc-dev@xxxxxxxxxxxxxxxxxxx
> Unsubscribe : https://launchpad.net/~ooc-dev
> More help   : https://help.launchpad.net/ListHelp
>

Follow ups

References