[m-dev.] declarative programming guide

[Mark Brown]

On Tue, Mar 21, 2023 at 4:05 PM Julien Fischer <jfischer at opturion.com> wrote:
>
>
> Hi Mark,
>
> On Tue, 21 Mar 2023, Mark Brown wrote:
>
> > On Tue, Mar 21, 2023 at 10:28 AM Julien Fischer <jfischer at opturion.com> wrote:
> >>
> >> On Mon, 20 Mar 2023, Mark Brown wrote:
> >>
> >>> I've been collecting notes from teaching people at work about
> >>> declarative programming, and formatting as a guide book (attached).
> >>> Could this go on the Mercury documentation page somewhere?
> >>
> >> Sure. It might be worth us cleaning up the documentation page, at least
> >> to the extent of distinguishing the official docmentation from tutorials
> >> and alike. (The official documentation seems to be getting pushed
> >> further and further down the page.)
> >
> > Agreed. If we have the canonical reference stuff at the top (Language
> > Ref, User Guide, Library Ref) then the section beneath that should be
> > easily spotted, and I think new users would quickly scroll down and
> > find tutorials.
>
> Actually, I was thinking of adding a "Tutorials" or "Learning" entry to
> the sidebar (just on top of "Papers") and moving all of the
> tutorial-style documentation to a separate page.

Sounds good to me.

Mark

>
> Julien.