Merge branch 'jit-stencils' of https://github.com/savannahostrowski/peps into jit-stencils

Author: savannahostrowski

peps/pep-0774.rst

@@ -3,7 +3,7 @@ Title: Removing the LLVM requirement for JIT builds
 Author: Savannah Ostrowski <savannah@python.org>
 Status: Draft
 Type: Standards Track
-Created: 26-Jan-2025
+Created: 27-Jan-2025
 Python-Version: 3.14
 
 Abstract
@@ -43,7 +43,7 @@ requirement for JIT builds in preparation for shipping the JIT off by default in
 pre-generated stencils for non-debug builds for Tier 1 platforms and that
 checking these files into the CPython repo would be adequate for the limited
 number of platforms (though more options have been explored; see `Rejected
-Ideas <PEP 774 Rejected Ideas_>`__).
+Ideas`_).
 
 Currently, building CPython with `the JIT requires LLVM
 <https://github.com/python/cpython/tree/main/Tools/jit#installing-llvm>`__ as a
@@ -109,7 +109,7 @@ and built for six platforms, so to start, we'd check in six stencil files. In
 the future, we may check in additional stencil files if support for additional
 platforms is desired or relevant.
 
-.. code-block:: bash
+.. code-block:: text
 
     cpython/
         Tools/
@@ -125,8 +125,8 @@ platforms is desired or relevant.
 Workflow
 --------
 
-To cover the workflow changes, this section can be divided into two parts -
-building CPython with the JIT enabled and working on the JIT's implementation.
+The workflow changes can be split into two parts, namely building CPython with
+the JIT enabled and working on the JIT's implementation.
 
 Building CPython with the JIT
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -142,7 +142,7 @@ on the precompiled stencil files directly from the repository.
 Working on the JIT's implementation (or touching JIT files)
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-In CI, stencil files will be automatically validated and updated when changes
+In continuous integration (CI), stencil files will be automatically validated and updated when changes
 are made to JIT-related files. When a pull request is opened that touches these
 files, the ``jit.yml`` workflow, which builds and tests our builds, will run as
 usual. 
@@ -180,8 +180,6 @@ Ignoring the stencils themselves and any necessary JIT README changes, the
 changes to the source code to support reproducible stencil generation and
 hosting are minimal (around 150 lines of changes).
 
-.. _PEP 774 Rejected Ideas:
-
 Rejected Ideas
 ==============
 
@@ -227,7 +225,7 @@ Hosting in cloud storage
 ------------------------
 
 Hosting stencils in cloud storage like S3 buckets or GitHub raw storage
-introduces external dependencies, potentially complicating offline development
+introduces external dependencies, complicating offline development
 workflows. Also, depending on the provider, this type of hosting comes with
 additional cost, which we'd like to avoid.