Skip to content

docs: Add zstd warning and compression guide with worked examples#2

Open
promptless-for-oss wants to merge 1 commit intoPeoplesGrocers:masterfrom
Promptless:promptless/zstd-warning-and-compression-examples
Open

docs: Add zstd warning and compression guide with worked examples#2
promptless-for-oss wants to merge 1 commit intoPeoplesGrocers:masterfrom
Promptless:promptless/zstd-warning-and-compression-examples

Conversation

@promptless-for-oss
Copy link

Addresses GitHub issue #1. Adds a note that zstd compression is not yet working, creates a new compression guide page with worked gzip examples, and adds a compression section to the demo README. The changes include:

  • Updated README.md to clarify that zstd is planned but not yet implemented
  • Created new docs/compression-guide.md with complete worked examples showing how to create, append to, and inspect compressed archives
  • Added compression section to docs/demo/README.md demonstrating usage with the existing demo files

Trigger Events

peoplesgrocers/json-archive#1

Promptless Research (1 GitHub Issue)

Agent Response

I've completed all the documentation updates requested in GitHub issue #1. Here's a summary of what I created:

Documentation Suggestion Created

Changes made:

  1. Updated README.md

    • Added a warning that zstd support is planned but not yet implemented
    • Removed zstd from the list of currently working compression formats
    • Added a link to the new compression guide in the Documentation section
  2. Created docs/compression-guide.md (new file)

    • Table of supported compression formats with status indicators
    • Complete worked example showing the gzip workflow:
      • Creating compressed archives
      • Appending to compressed archives
      • Inspecting compressed archives with info and state commands
      • Comparing file sizes between compressed and uncompressed
    • Documented caveats about temporary filesystem requirements
    • Guidance on when to use (and when not to use) compression
  3. Updated docs/demo/README.md

    • Added section documenting the existing compressed demo files (v1.json.archive.gz, v1.json.archive.zst)
    • Included examples showing how to use the gzip archive with the demo files
    • Noted that the zstd file isn't working yet
    • Linked to the full compression guide for more examples

The suggestion is ready for your review.


Tip: This PR was generated by Promptless via Hacker News. Book a demo to learn how Promptless can keep your docs in sync automatically 📅

Signed-off-by: promptless-for-oss <promptless-for-oss@users.noreply.github.com>
@@ -0,0 +1,99 @@
# Compression
Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Citation: Created new compression guide in response to issue requesting worked examples for compression format usage. Added the table of supported formats with zstd marked as not working yet, plus complete gzip workflow examples.
View source

While the core design keeps things simple and readable, the tool does work with compressed archives as a practical concession for those who need it. You can read from and write to gzip, deflate, zlib, brotli, and zstd compressed files without special flags.
While the core design keeps things simple and readable, the tool does work with compressed archives as a practical concession for those who need it. You can read from and write to gzip, deflate, zlib, and brotli compressed files without special flags.

**⚠️ Note:** zstd support is planned but not yet implemented. Use one of the other compression formats for now.
Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Citation: Added zstd warning per issue report that zstd is not working yet. Also removed zstd from the list of working compression formats and linked to the new compression guide.
View source

Copy link

@InlinePizza InlinePizza Feb 24, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@promptless-for-oss Can you say that zstd support is partially implemented in the code but not functioning. As in the zstd library is in the binary but not wired up to the command line parsing. basically the zstd does not really have a standard extension, so I have not decided what the auto detection should be or if there should be a flag to set the format to zstd.

@promptless-for-oss
Copy link
Author

@InlinePizza ✅ Promptless drafted a docs update: #2

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants