Skip to content

Improve comprehensiveness of first docstring - #1789

Merged
bakpakin merged 1 commit into
janet-lang:masterfrom
sogaiu:update-first-docstring
Aug 2, 2026
Merged

Improve comprehensiveness of first docstring#1789
bakpakin merged 1 commit into
janet-lang:masterfrom
sogaiu:update-first-docstring

Conversation

@sogaiu

@sogaiu sogaiu commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

This PR is an attempt to improve the comprehensiveness of the docstring for first based on exploration and discussion at our Zulip instance [1].

Highlights for the candidate in this PR include:

  • avoids the use of the term "indexed data structure"
  • enumerates the specific kinds of values that are non-trivially handled (including fibers and abstract types)
  • spells out that nil is returned for other cases
  • aligns better with the newly added website docs examples in this PR

Thanks to all discussion participants. Hopefully this PR is seen as acceptable 🤞


[1] Discussion is mostly between here and here.

@sogaiu
sogaiu force-pushed the update-first-docstring branch 2 times, most recently from 952b6c7 to 6292c5a Compare August 2, 2026 07:01
@sogaiu
sogaiu force-pushed the update-first-docstring branch from 6292c5a to c8e0335 Compare August 2, 2026 07:05
@bakpakin

bakpakin commented Aug 2, 2026

Copy link
Copy Markdown
Member

Seems a bit verbose to me, but I suppose for such an important function it can be a bit longer.

@bakpakin
bakpakin merged commit f362e8f into janet-lang:master Aug 2, 2026
18 checks passed
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

Successfully merging this pull request may close these issues.

2 participants