1
8
Fork
You've already forked janetdocs
2

Duplicate names and thus examples #10

Open
opened 2026年02月07日 07:50:56 +01:00 by veqq · 0 comments
Owner
Copy link

https://janetdocs.org/joy%2fdb%2fgroup-by and https://janetdocs.org/joy%2fgroup-by both exist. Upon importing joy, both variants are available but only joy/group-by has documentation (because the extended versions aren't :export true internally).

The core issue's that an example only refers to one version.

As they're undocumented, removing or perhaps symlinking the extended forms might makes sense - but both work in code so I don't know how to avoid this situation.

Widening examples to optionally refer to multiple functions could work - indeed, it would allow interesting examples relying on multiple to "tag" them all. Of course, we don't want anything using common things like string to pollute string's page.

https://janetdocs.org/joy%2fdb%2fgroup-by and https://janetdocs.org/joy%2fgroup-by both exist. Upon importing `joy`, both variants are available but only `joy/group-by` has documentation (because the extended versions aren't `:export true` internally). The core issue's that an example only refers to one version. As they're undocumented, removing or perhaps symlinking the extended forms might makes sense - but both work in code so I don't know how to avoid this situation. Widening examples to optionally refer to multiple functions could work - indeed, it would allow interesting examples relying on multiple to "tag" them all. Of course, we don't want anything using common things like `string` to pollute `string`'s page.
Sign in to join this conversation.
No Branch/Tag specified
master
repo-index
No results found.
Labels
Clear labels
No items
No labels
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
veqq/janetdocs#10
Reference in a new issue
veqq/janetdocs
No description provided.
Delete branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?