On 04/03/2014 09:33 AM, Martin Baker wrote: > Well, there’s the dilemma of open source projects. If everyone does > their own thing then the documentation will remain fragmented, > incomplete and unimpressive to new users. I think such a project > does require some sort of direction from the person leading the > project.
I cannot speak for Waldek, but I'd rather have him work on something else. > It does not seem very helpful to suggest everyone goes out and writes > their own documentation system. No, of course, not. If that is done then we keep producing the mess we have now. I would rather suggest that anyone who is interested to work on improvement of the documentation, does that in public. I haven't yet seen a concrete plan form anyone. > I think it needs something very very simple which requires no new > learning, i.e. it can be done with a WYSIWYG editor. Then document > standards need to be enforced. Looks like you are opting for the TeXmacs interface. Personally, I see the power of TeXmacs, but I'm somehow not such a big fan of it. Each time I start using it, it feels unnatural to me. I'd rather like to translate the .htex files into ReStructuredText and then use Sphinx to render nice webpages out of it. There is still the aspect of the dynamic part of HyperDoc, i.e. asking for the category exports etc. etc. But it's only a small part of newly user-defined domains that one would lose. The other stuff can be staticly documented from the ++ docstrings. Ralf -- You received this message because you are subscribed to the Google Groups "FriCAS - computer algebra system" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. Visit this group at http://groups.google.com/group/fricas-devel. For more options, visit https://groups.google.com/d/optout.
