bazelbuild / bazelbuild/stardoc

Cut a release that includes support for keyword-only arguments

Open
#52 2 comments 0 reactions 0 assignees View on GitHub
P4 type: process
Dominant language
Java
Stars
118
Forks
51
PR merge metrics
No merged PRs in 30d

Description

[Bazel 2.1 instroduced Starlark changes that allow keyword-only parameters](https://blog.bazel.build/2020/02/06/bazel-2.1.html).

For example:

```bzl
def foo(arg1, arg2, *, kwonly1):
pass
```

But running Stardoc 0.4.0 on `.bzl` files with that new syntax fails with:

```
Stardoc documentation generation failed: Starlark evaluation error
```

Contributor guide

Open the contributing guide

Research direction

Reproduce the failure by running Stardoc 0.4.0 against a .bzl file using the keyword-only example in the issue. Trace the Starlark evaluation failure, then verify that documentation generation succeeds and that a release includes support for this syntax.

Written by the indexing model from the issue text.

Assessment

Tech stack
java
Domain
documentation
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
28/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.