adambard / adambard/learnxinyminutes-docs
[Prolog] operator x->y is hastily introduced and then used in a complex example
Open
- 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
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