Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Reference Guide: Code blocks chapter calls Function a code block #1499

Open
Chealer opened this issue Aug 24, 2023 · 0 comments
Open

Reference Guide: Code blocks chapter calls Function a code block #1499

Chealer opened this issue Aug 24, 2023 · 0 comments

Comments

@Chealer
Copy link

Chealer commented Aug 24, 2023

Section Function in the Code Blocks chapter of the reference guide opens with:

The Function code block in its most common usage takes each element of a collection as the argument to the code-block logic.

The chapter's introduction defines code blocks as objects (instances). Function is an interface, not a code block. I suggest:

An object which implements Function is a code block. In its most...

By the way

I noticed a couple more issues in that chapter.


In the Predicate section above, the first row of the first table claims a predicate...

Evaluates each element of a collection (the argument), and returns a boolean value.

This is not necessarily true. A Predicate is not necessarily used with a filter, and even if it was, not all filters have to treat each element. I suggest:

Tests an object (the argument) and returns a boolean value.


The Function and Procedure types are complex (at least relative to Predicate). They could surely each also use at least 1 example.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant