Page 1 of 1

Order of contents in User Manual

Posted: Fri Feb 17, 2017 1:30 am
by dram
Hi all,

I'm a newbie to Logtalk, when first looking into Logtalk, I really appreciate the richness of Logtalk's documents, thanks for your hard work!

Here is a simple suggestion, related to contents order of User Manual. I kind of think that it would be better to move "Installing Logtalk" and "Writing, Running, and Debugging Logtalk Applications" up to the top of the manual. As a first time user, the things to do is usually installing Logtalk and running some "hello world" examples.

Following are documents of some other languages which have similar order as suggested:

- Python:
- MIT Scheme: ... heme-user/
- Rust:

Re: Order of contents in User Manual

Posted: Sat Feb 18, 2017 12:40 pm
by Paulo Moura
Welcome. The manuals indeed need a big overhaul. Most of the text was written 18 years ago. Improving them is on the TODO list but not the top priority currently I'm afraid. For new users, I strongly recommend that you start here:

After, I suggest you start playing, running, modifying the programming examples in the distribution. Use the examples file to guide you accordingly to your interests: ... s/


Re: Order of contents in User Manual

Posted: Mon Feb 20, 2017 5:15 am
by dram
Thanks for your suggestions, I'll go through "Learn X in Y minutes" tutorial and examples in the distribution.

BTW, is there any TODO list or roadmap around? I have checked both at Logtalk website and github repo, but failed to find one. It will help convey the direction of Logtalk's development.

Re: Order of contents in User Manual

Posted: Mon Feb 20, 2017 3:11 pm
by Paulo Moura
There isn't currently any public TODO or roadmap.