[m-dev.] declarative programming guide

[Julien Fischer]

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.

Julien.