adambard / adambard/learnxinyminutes-docs

[Prolog] operator x->y is hastily introduced and then used in a complex example

Open
#3,515 0 comments 1 reaction 0 assignees View on GitHub
Dominant language
Markdown
Stars
12.3k
Forks
3.7k
Avg merge
13h 10m
Merged PRs (30d)
6

Description

`->` is introduced in `countUpTo2` as a "more elegant syntax" equivalent to `countUpTo`, but its meaning is not really explained, and the next example `safe` flies over the reader's head because of that.

Contributor guide

Open the contributing guide

Research direction

Locate the Prolog document containing the countUpTo, countUpTo2, and safe examples, then read those examples together. Done means the meaning of -> is explained before safe and the example no longer assumes readers understand the operator from context.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.