Skip to content

Commit e79f5a9

Browse files
authored
docs: add lumberjack 17 release notes (#204)
## PR Checklist Please check if your PR fulfills the following requirements: - [ ] The commit message follows our guidelines: CONTRIBUTING.md#commit - [ ] Tests for the changes have been added (for bug fixes / features) - [x] Docs have been added / updated (for bug fixes / features) ## PR Type What kind of change does this PR introduce? <!-- Please check the one that applies to this PR using "x". --> ``` [ ] Bugfix [ ] Feature [ ] Code style update (formatting, local variables) [ ] Refactoring (no functional changes, no api changes) [ ] Build related changes [ ] CI related changes [x] Documentation content changes [ ] Other... Please describe: ``` ## What is the current behavior? We are ready to lunch but we haven't written the release notes for version 17 Closes: #193 ## What is the new behavior? The release notes for version 17 are ready to be published. ## Does this PR introduce a breaking change? ``` [ ] Yes [x] No ```
1 parent 6d75549 commit e79f5a9

File tree

1 file changed

+71
-0
lines changed

1 file changed

+71
-0
lines changed
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,71 @@
1+
---
2+
title: 'Announcing Lumberjack v17: Literal Union Levels, Angular 17 and a new Contributor'
3+
description: Lumberjack v17 is on as promised, here is what's new.
4+
slug: announcing-lumberjack-v17
5+
authors:
6+
- name: Nacho Vazquez
7+
title: NgWorker and core maintainer of Lumberjack
8+
url: https://github.com/NachoVazquez
9+
image_url: https://github.com/NachoVazquez.png
10+
tags: [announcement, lumberjack, v16]
11+
image: https://pub-2294738bc2c249ff8040505bf960c018.r2.dev/logo.svg
12+
hide_table_of_contents: false
13+
---
14+
15+
As promised, we are getting up to speed with Angular versions. We are happy to announce that Lumberjack v17 is here.
16+
17+
**TL;DR** - Lumberjack version 17 introduces the following: Support for string literal unions as log levels, deprecation of enum-based log levels, alignment with Angular 17 upgrading to the latest Nx, and a special new contributor.
18+
19+
## String Literal Unions Log Levels
20+
21+
In our continued pursuit of DX happiness, we are happy to introduce string literal unions as log levels.
22+
23+
String literal unions are less verbose than enums, and since they don't have a runtime implementation, they also make our bundle size lighter.
24+
25+
The new log levels are:
26+
27+
```ts
28+
export type Level = 'critical' | 'debug' | 'error' | 'info' | 'trace' | 'verbose' | 'warn';
29+
```
30+
31+
You can use the new API anywhere you were using the enum-based log levels:
32+
33+
Before:
34+
35+
```ts
36+
this.#lumberjack.log({
37+
level: LumberjackLevel.Info,
38+
message: 'Hello, World!',
39+
scope: 'MyComponent',
40+
createdAt: this.#time.getUnixEpochTicks(),
41+
});
42+
```
43+
44+
Now:
45+
46+
```ts
47+
this.#lumberjack.log({
48+
level: 'info',
49+
message: 'Hello, World!',
50+
scope: 'MyComponent',
51+
createdAt: this.#time.getUnixEpochTicks(),
52+
});
53+
```
54+
55+
## Enum-based Log levels deprecation
56+
57+
As part of the introduction to string literal unions, we are deprecating the enum-based log levels.
58+
59+
Once removed in version 19, we can reduce the bundle size and simplify the API.
60+
61+
## Community
62+
63+
On this version, we had the star collaboration of [Diego Julião](https://github.com/dianjuar) core maintainer of [ngx-deploy-npm](https://github.com/bikecoders/ngx-deploy-npm).
64+
65+
Diego helped us upgrade our deployment process to use the latest version of `ngx-deploy-npm`.
66+
67+
Thanks, Diego!
68+
69+
## Wrapping Up
70+
71+
That's it, folks. Last time, we promised to release a new version of Lumberjack quickly, and we did it. We are happy to be able to keep our promises. Now that we are up to date with Angular, you should expect more news on our [secret project](https://ngworker.github.io/lumberjack/blog/announcing-lumberjack-v16/#ambitious-secret-project) soon

0 commit comments

Comments
 (0)