Skip to content

Commit b339570

Browse files
doc: document console changes as breaking
1 parent 40ef2da commit b339570

File tree

1 file changed

+16
-0
lines changed

1 file changed

+16
-0
lines changed

doc/contributing/collaborator-guide.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,7 @@
1919
* [Breaking changes](#breaking-changes)
2020
* [Breaking changes and deprecations](#breaking-changes-and-deprecations)
2121
* [Breaking changes to internal elements](#breaking-changes-to-internal-elements)
22+
* [Breaking changes to console APIs](#breaking-changes-to-console-apis)
2223
* [Unintended breaking changes](#unintended-breaking-changes)
2324
* [Reverting commits](#reverting-commits)
2425
* [Introducing new modules](#introducing-new-modules)
@@ -350,6 +351,7 @@ Examples of breaking changes include:
350351
* Adding or removing errors.
351352
* Altering expected timing of an event.
352353
* Changing the side effects of using a particular API.
354+
* Changing the output of some [console APIs](#breaking-changes-to-console-apis).
353355

354356
#### Breaking changes and deprecations
355357

@@ -373,6 +375,20 @@ an effort to determine the potential impact of the change in the ecosystem. Use
373375
If a change will cause ecosystem breakage, then it is semver-major. Consider
374376
providing a Public API in such cases.
375377

378+
### Breaking changes to console APIs
379+
380+
Console APIs are a debugging tool, and the format of their output should generally not
381+
considered stable.
382+
However due to the nature of the Node.js ecosystem, users rely on stability of
383+
the output of some of these APIs for snapshot testing, parsers, etc...
384+
To avoid breaking changes, some behaviors should be considered stable.
385+
The following changes in the output are to be considered breaking changes:
386+
387+
* `console.table` (padding, alignment, etc...).
388+
* changing the color of all console methods.
389+
* changing the signature of all console methods.
390+
* changing the output for single string inputs.
391+
376392
#### Unintended breaking changes
377393

378394
Sometimes, a change intended to be non-breaking turns out to be a breaking

0 commit comments

Comments
 (0)