Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Documentation unclear: compression

Aperta
  • Qualcosa non va?
#7,991 3 commenti 1 reazione 2 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

@seshadhri-aswath ci sta già lavorando.

Dal 18/8/2025.

Valutazione

Questa issue non è ancora stata valutata.

Descrizione

Hi,

I have a few issues with the compression documentation.

It was outlined here: https://openliberty.io/blog/2020/04/22/http-response-compression.html
The actual docs I am referring to: https://openliberty.io/docs/latest/reference/config/compression.html

Here are some enhancements I would like to suggest:

Compression algorithm

currently, we have support for:

  • gzip,
  • x-gzip,
  • deflate,
  • zlib,
  • identity
Update wish / recommendation
  • Please explain each item (I thought deflate is the algorithm used in gz?).
  • Mention identity equals no-compression
  • Mention zlib is hardly supported by browsers
  • Mention zlib has AIX hardware support (has it?)
Future perspective: brotli, lz4 and zstd

Modern browsers will send: Accept-Encoding: gzip, deflate, br, zstd (Firefox, Edge, others).

Please document the small overlap and maybe reference wishlist issues / github RFE issues for br (brotli) and zstd (and maybe lz4).

serverPreferredAlgorithm

This is an attribute, interestingly. Make that information stand out, maybe add an example. Usually server.xml uses tags only, so this is somewhat unexpected.

Luckily, <config onError="fail" /> will make the startup fail.

types

Invalid tags won't fail the start

<config onError="fail" /> will NOT make the startup fail if you accidentally use <type> instead of <types>.
Please mention this explicitly (and why it DOES fail for <serverPreferredAlgorithm>, see above section).

Give examples of configurations

Give an example snipped for the default configuration

combination of no prefix, + and -

What happens if you combine those?

<compression>
  <types>text/plain</types>
  <types>+text/*</types>
  <types>-text/xml</types>
</compression>

What would be the outcome? What takes precedence? What about other combinations?

minGzipSize

This option is not documented

Thanks!

Lingua principale
Nessun dato sulla lingua
Stelle
14
Fork
58
Merge medio
1h 4m
PR unite (30g)
21

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di OpenLiberty/docs

Tutte le issue di OpenLiberty/docs

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.