On Mon, Jun 8, 2020 at 10:15 AM ToddAndMargo via perl6-users < perl6-us...@perl.org> wrote:
> On 2020-06-08 00:48, Fernando Santagata wrote: > > On Mon, Jun 8, 2020 at 9:12 AM ToddAndMargo via perl6-users > > <perl6-us...@perl.org <mailto:perl6-us...@perl.org>> wrote: > > > > On 2020-06-07 22:39, Peter Pentchev wrote: > >> I addressed this in my original e-mail: the documentation is > > currently: > >> 1. a reference manual > > > > Targets at what audience? > > > > I think that that point has been stressed countless times: you > > probably want a User Manual, not a Reference. The online Reference is > > well written and it's what most people need. To learn more about Raku > > please refer to the numerous books on the topic: > > > > https://perl6book.com/ https://raku.org/resources/ > > User Manual and Reference Manual are synonyms. Or > as the Raku web site calls it: Documentation. > As far as I remember there were times when manuals were printed on real paper and the Reference Manual was a dry thing used - well - as a reference, while the User Manual addressed task-based topics. For example, the User Manual would address the task of how to compile, link, and run a simple program, while the Reference Manual would list all the possible command line switches. -- Fernando Santagata
