• 
      

    Add draft release notes for Djblets 4.0 beta 1.

    Review Request #12898 — Created March 20, 2023 and submitted

    Information

    Djblets
    release-4.x

    Reviewers

    Djblets 4.0 beta 1 is almost entirely composed of changes related to our
    JS build infrastructure, introducing TypeScript and rollup.js.

    Built release notes docs.

    Summary ID
    Add draft release notes for Djblets 4.0 beta 1.
    Djblets 4.0 beta 1 is almost entirely composed of changes related to our JS build infrastructure, introducing TypeScript and rollup.js. This also lists out the deprecated code that was removed. Testing Done: Built release notes docs.
    611badfde20b37c399f3602f2b2e0ff3c87f43cb
    Description From Last Updated

    We should add a djblets.deprecation section that talks about the functions now available to consumers (commit 066be07e).

    chipx86chipx86

    We should explicitly document the following under a djblets.pipeline section: use_rollup argument on djblets.pipeline.settings.build_pipeline_settings djblets.pipeline.compilers.rollup `djblets.pipeline.compilers.typescript djblets.pipeline.compilers.mixins.SourceMapStaleCheckMixin We have the …

    chipx86chipx86

    I thought it still supported 3.7 too? I might just be mistaken though.

    maubinmaubin

    Missing a period.

    chipx86chipx86

    Let's link to this. We can add an extlink in conf.py for :npm:.

    chipx86chipx86

    Let's link to TypeScript and rollup.js, and separate out the first sentence from the rest of the paragraph so it …

    chipx86chipx86

    Missing period.

    chipx86chipx86

    Missing period.

    chipx86chipx86

    Wrapping is broken here. This won't render correctly.

    chipx86chipx86

    For now, this will have to point to dev/, since we can't currently have versioned docs for in-development versions (latest …

    chipx86chipx86
    maubin
    1. 
        
    2. docs/releasenotes/4.0-beta-1.rst (Diff revision 1)
       
       
      Show all issues

      I thought it still supported 3.7 too? I might just be mistaken though.

      1. You're right, the decision we had made was for the betas to keep it, and reevaluate for final depending on when we ship.

    3. 
        
    david
    chipx86
    1. 
        
    2. Show all issues

      We should add a djblets.deprecation section that talks about the functions now available to consumers (commit 066be07e).

      1. Isn't all of that part of 3.2?

    3. docs/releasenotes/4.0-beta-1.rst (Diff revision 2)
       
       
      Show all issues

      Missing a period.

    4. docs/releasenotes/4.0-beta-1.rst (Diff revision 2)
       
       
      Show all issues

      Let's link to this. We can add an extlink in conf.py for :npm:.

    5. docs/releasenotes/4.0-beta-1.rst (Diff revision 2)
       
       
       
       
       
      Show all issues

      Let's link to TypeScript and rollup.js, and separate out the first sentence from the rest of the paragraph so it stands out (this would normally be the main line of the bullet point, I think).

      The work also benefits extensions, which can use TypeScript and ES5 modules. We may want to put up something in a djblets.extensions section specifically about that.

      1. I think I'll just add that in here as an extra paragraph. We can go into much more detail in the RB documentation for extensions.

    6. 
        
    david
    david
    chipx86
    1. 
        
    2. Show all issues

      We should explicitly document the following under a djblets.pipeline section:

      • use_rollup argument on djblets.pipeline.settings.build_pipeline_settings
      • djblets.pipeline.compilers.rollup
      • `djblets.pipeline.compilers.typescript
      • djblets.pipeline.compilers.mixins.SourceMapStaleCheckMixin

      We have the general stuff about packaging, but these are API, not internal, so we need entries for them.

    3. 
        
    david
    david
    chipx86
    1. 
        
    2. docs/releasenotes/4.0-beta-1.rst (Diff revisions 4 - 6)
       
       
      Show all issues

      Missing period.

    3. docs/releasenotes/4.0-beta-1.rst (Diff revisions 4 - 6)
       
       
      Show all issues

      Missing period.

    4. docs/releasenotes/4.0-beta-1.rst (Diff revisions 4 - 6)
       
       
       
      Show all issues

      Wrapping is broken here. This won't render correctly.

    5. docs/releasenotes/conf.py (Diff revision 6)
       
       
      Show all issues

      For now, this will have to point to dev/, since we can't currently have versioned docs for in-development versions (latest versioned doc is considered current).

    6. 
        
    david
    david
    chipx86
    1. Ship It!
    2. 
        
    david
    Review request changed
    Status:
    Completed
    Change Summary:
    Pushed to release-4.x (febbd80)