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)