4 ms·
Really? I think the documentation is up to par: http://mozart.github.io/mozart-v1/doc-1.4.0/ http://mozart.github.io/mozart-v1/doc-1.4.0/ Clearly, it's possibl
by norswap 9y ago
Really? I think the documentation is up to par: http://mozart.github.io/mozart-v1/doc-1.4.0/ http://mozart.github.io/mozart-v1/doc-1.4.0/
Clearly, it's possible to do better. It's also possible to do much worse, and it is often done.
- Zalastax 9y agoAs an outsider taking a quick look I found it difficult to navigate. Guided by a course that can be fine, but without that I have no idea where to start. Compare that with the tours of D and go: https://tour.dlang.org/ https://tour.dlang.org/ & https://tour.golang.org https://tour.golang.org
- mncharity 9y agoAt least back in 2004, the Oz documentation was sufficiently problematic that I wrote a VirtualManual[1]. > Mozart/Oz has a lot of documentation. Many documents, papers, lecture notes, etc, and several web pages which list them. And subjects are often discussed in several documents. This page attempts to integrate the documentation, saying "for subject foo, see these n sources". I expect the links are mostly rotted now. The scattered fragmentation of the documentation was tolerable once you were familiar with both the language and its documents. But for new users, especially those without the Oz textbook, it was a serious barrier. Glad to hear it's now much better. Thank you for the reminder of all this -- my anonymously-editable Oz wiki was still running, gathering unindexed spam. Static partial snapshot now. Activity moved to an official wiki a decade ago. Perhaps sometime, I'll look to see if any of its other pages, were also still linked to or used, or of possible historical interest, and restore them too. Thanks again. [1] http://www.vendian.org/oz/wiki/index.cgi?VirtualManual http://www.vendian.org/oz/wiki/index.cgi?VirtualManual