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

Streamline and modernize naming #1663

Merged
merged 4 commits into from
Nov 18, 2024

Conversation

wycats
Copy link
Contributor

@wycats wycats commented Nov 14, 2024

This PR pulls out the naming and documentation changes in #1649 so they can be landed separately.

The naming changes are focused on:

  1. Removing distinctions that only existed between JIT and AOT mode.
  2. Renaming most of the leftover "JIT" naming to just refer to the VM (which only has a JIT mode now)
  3. Consolidating interfaces in situations where the separate interfaces were never used to implement separate implementations of things. For example, there is only a single implementation of Constants, Program, Heap, etc, and the previous factoring was put into place for AOT mode.
  4. Renaming tree builder concepts to use the term "tree builder" rather than "elements".

mise.toml Outdated Show resolved Hide resolved
- This commit continues the process of clearly documenting how the
methods on `VM` affect the VM state.
- Removes a number of duplicate methods that made the surface of
the VM seem more elaborate than it actually is.
- Consolidates the various "contexts" further to clarify the different
  kinds of state and the conditions under which they can change.
- Further cleanup the debug state to make it clearer when explicit
  snapshots are necessary but allow stable objects on `debug` when
  they are appropriate.
@wycats wycats force-pushed the internals/streamline-and-modernize-naming branch from 4f64f7e to 7d7d1bd Compare November 15, 2024 00:42
@wycats wycats marked this pull request as ready for review November 15, 2024 22:33
export type RemoteLiveBlock = SimpleLiveBlock;

export interface UpdatableBlock extends SimpleLiveBlock {
/**
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I like these much better than their previous names

readonly stdlib: STDLib;

/**
* A framework-specified resolver for resolving free variables in classic templates.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I super appreciate all these inline comments!

Copy link
Contributor

@NullVoxPopuli NullVoxPopuli left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm!

@NullVoxPopuli NullVoxPopuli merged commit 33ed91b into main Nov 18, 2024
5 checks passed
@NullVoxPopuli NullVoxPopuli deleted the internals/streamline-and-modernize-naming branch November 18, 2024 19:28
@github-actions github-actions bot mentioned this pull request Nov 14, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants