Skip to content

Comments

docs(ast): docs for AstBuilder *_with_* methods list extra field names, not field types#9206

Merged
graphite-app[bot] merged 1 commit intomainfrom
02-18-docs_ast_docs_for_astbuilder__with__methods_list_extra_field_names_not_field_types
Feb 18, 2025
Merged

docs(ast): docs for AstBuilder *_with_* methods list extra field names, not field types#9206
graphite-app[bot] merged 1 commit intomainfrom
02-18-docs_ast_docs_for_astbuilder__with__methods_list_extra_field_names_not_field_types

Conversation

@overlookmotel
Copy link
Member

@overlookmotel overlookmotel commented Feb 18, 2025

In docs for AstBuilder methods, list the extra field names, not the type of the fields. When we add default fields which are bool e.g. no_side_effects: bool, this will produce comments that make more sense.

Before:

/// Build a [`Program`] with `ScopeId`.
/// Build a [`Function`] with `bool`.

After:

/// Build a [`Program`] with `scope_id`.
/// Build a [`Function`] with `no_side_effects`.

@github-actions github-actions bot added A-ast Area - AST A-ast-tools Area - AST tools C-docs Category - Documentation. Related to user-facing or internal documentation labels Feb 18, 2025
Copy link
Member Author

overlookmotel commented Feb 18, 2025


How to use the Graphite Merge Queue

Add either label to this PR to merge it via the merge queue:

  • 0-merge - adds this PR to the back of the merge queue
  • hotfix - for urgent hot fixes, skip the queue and merge this PR next

You must have a Graphite account in order to use the merge queue. Sign up using this link.

An organization admin has enabled the Graphite Merge Queue in this repository.

Please do not merge from GitHub as this will restart CI on PRs being processed by the merge queue.

This stack of pull requests is managed by Graphite. Learn more about stacking.

@codspeed-hq
Copy link

codspeed-hq bot commented Feb 18, 2025

CodSpeed Performance Report

Merging #9206 will not alter performance

Comparing 02-18-docs_ast_docs_for_astbuilder__with__methods_list_extra_field_names_not_field_types (70726e9) with main (be27164)

Summary

✅ 33 untouched benchmarks

@Boshen Boshen added the 0-merge Merge with Graphite Merge Queue label Feb 18, 2025
Copy link
Member

Boshen commented Feb 18, 2025

Merge activity

  • Feb 18, 9:49 AM EST: The merge label '0-merge' was detected. This PR will be added to the Graphite merge queue once it meets the requirements.
  • Feb 18, 9:49 AM EST: A user added this pull request to the Graphite merge queue.
  • Feb 18, 10:05 AM EST: A user merged this pull request with the Graphite merge queue.

…names, not field types (#9206)

In docs for `AstBuilder` methods, list the extra field names, not the *type* of the fields. When we add default fields which are `bool` e.g. `no_side_effects: bool`, this will produce comments that make more sense.

Before:

```rs
/// Build a [`Program`] with `ScopeId`.
/// Build a [`Function`] with `bool`.
```

After:

```rs
/// Build a [`Program`] with `scope_id`.
/// Build a [`Function`] with `no_side_effects`.
```
@graphite-app graphite-app bot force-pushed the 02-18-feat_ast_tools_add_builder_skip_attribute_for_structs_and_enums branch from 5c44e0c to 124b3cb Compare February 18, 2025 14:51
@graphite-app graphite-app bot force-pushed the 02-18-docs_ast_docs_for_astbuilder__with__methods_list_extra_field_names_not_field_types branch from 8a76d33 to 70726e9 Compare February 18, 2025 14:51
Base automatically changed from 02-18-feat_ast_tools_add_builder_skip_attribute_for_structs_and_enums to main February 18, 2025 15:01
@graphite-app graphite-app bot merged commit 70726e9 into main Feb 18, 2025
28 checks passed
@graphite-app graphite-app bot deleted the 02-18-docs_ast_docs_for_astbuilder__with__methods_list_extra_field_names_not_field_types branch February 18, 2025 15:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

0-merge Merge with Graphite Merge Queue A-ast Area - AST A-ast-tools Area - AST tools C-docs Category - Documentation. Related to user-facing or internal documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants