Skip to content

* the README follows the house convention - #14

Merged
Hawkynt merged 1 commit into
mainfrom
readme-convention
Sep 11, 2026
Merged

Hawkynt merged 1 commit into
mainfrom
readme-convention

Conversation

@Hawkynt

@Hawkynt Hawkynt commented Sep 9, 2026

Copy link
Copy Markdown
Owner

Brings this repository's README into line with the house convention now defined in
repo-readme/README.md,
and switches the check on so it stays that way.

The README is a funnel: the pitch catches the reader, 🧭 Vision and ✨ Features say what the thing
is, 📦 Installation and 🚀 Quick start get them running, the middle goes deeper, and what a
contributor needs closes the file. One emoji means one thing, and a section shared with the package
README convention carries the same name and emoji in both.

No prose was dropped — sections were renamed, reordered, and where the convention asks for something
that was missing, it was written.

The file opened with a hundred and forty lines of CLI help under no heading at
all. That becomes a CLI reference section, and Vision, Features, Installation,
Quick start and Building are added around it, so the first screen now says what
the tool is and how to run it rather than listing every option.

Overview, Practical considerations and Converting video keep their content and
gain the emoji the vocabulary asks for.

Switches the repo-readme check on so it stays that way.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 84659be6e0

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread README.md
## 📦 Installation

Download the executable from the [latest release](../../releases/latest) (or a `nightly-*`
prerelease). The GIF file-format primitives are also published on nuget.org as `GifFileFormat`.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Use the actual NuGet package ID

The published package is Hawkynt.GifFileFormat (GifFileFormat/GifFileFormat.csproj sets that PackageId, and its package README uses dotnet add package Hawkynt.GifFileFormat). Naming it as GifFileFormat in the installation section directs users toward the wrong package identifier; use the full ID so the documented installation path is actionable.

Useful? React with 👍 / 👎.

Comment thread README.md
Comment on lines +58 to +59
Every knob has a default that produces something reasonable; the [CLI reference](#-cli-reference)
below lists them.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Refresh the CLI reference before claiming it lists every option

The reference omits the currently registered --maxFrames, --frameDuration, --totalTime, --serpentine, and --disallowFillingColors options from AnythingToGif/CLI/Options.cs:135-148. Users relying on this new promise cannot discover several output-timing and dithering controls, so regenerate the embedded help or avoid claiming that every knob is listed.

Useful? React with 👍 / 👎.

Comment thread README.md

```bash
dotnet build -c Release
dotnet test

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Document that tests require Windows

On Linux or macOS, the newly documented dotnet test command cannot run this solution: the tests target net8.0-windows, and docs/LINUX-TEST-BLOCKER.md records the transitive Microsoft.WindowsDesktop.App.WindowsForms dependency as Windows-only. Add the Windows prerequisite or provide a platform-specific command so non-Windows contributors are not sent through a known failing setup.

Useful? React with 👍 / 👎.

@Hawkynt
Hawkynt merged commit 6868ade into main Sep 11, 2026
3 checks passed
@Hawkynt
Hawkynt deleted the readme-convention branch September 11, 2026 16:59
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.

1 participant