Skip to content

docs: fix typos in comments and documentation - #81

Open
Avicennasis wants to merge 1 commit into
Tinder:mainfrom
Avicennasis:docs/fix-typos
Open

docs: fix typos in comments and documentation#81
Avicennasis wants to merge 1 commit into
Tinder:mainfrom
Avicennasis:docs/fix-typos

Conversation

@Avicennasis

Copy link
Copy Markdown

Summary

Fixes 23 spelling/grammar defects in KDoc comments, inline comments, CLI help text and Markdown docs. No logic changes.

Subject-verb agreement on the config-file description (same sentence, copy-pasted into five places)

  • cli/src/main/kotlin/com/tinder/gitquery/cli/GitQueryCli.kt: A yaml file that describe a set of files -> describes
  • core/.../GitQuerySync.kt: @param config a yaml file that describe a set of files -> describes
  • core/.../GitQueryInit.kt: @param config a yaml file that describe a set of files -> describes
  • gradle-plugin/.../GitQuerySyncTask.kt: path to a yaml file that describe a set of files -> describes
  • README.md: the pasted --help output carries the same sentence, updated so it still matches the CLI

Other typos in comments / KDoc

  • cli/.../GitQueryCli.kt: override the same value in config is they are defined -> if they are defined
  • core/.../utils/RepoUtils.kt: Since we have th repo already -> the repo
  • core/.../config/GitQueryConfig.kt: directories to files and file to revisions ... included file that we want -> files to revisions ... included files that we want (parallel plurals)
  • core/.../config/GitQueryConfig.kt: @param filename to path to save to. -> @param filename the path to save to.
  • gradle-plugin/.../GitQuerySyncTask.kt: An boolean -> A boolean

Additionally noticed (not in the original report, found while reading the surrounding files)

  • core/.../config/GitQueryConfigSchema.kt: A model fof the schema attribute -> A model for the schema attribute
  • core/.../config/GitQueryInitConfig.kt and gradle-plugin/.../GitQueryInitTask.kt: in the resulted saved config file -> in the resulting saved config file
  • cli/.../GitQueryCli.kt and README.md: a flat map or a nest map -> a flat map or a nested map (the --flat-files help text and its mirror in the README)
  • README.md: at the root fo the remote repo -> of; unneccesary -> unnecessary; the sames ones we were using -> the same ones; including pre-build artifacts -> pre-built (matches "pre-built and published artifacts" earlier in the same file); a few files from large remote monorepo -> from a large remote monorepo
  • samples/sample1.yml: included file that we want -> included files that we want (same sentence as the GitQueryConfig KDoc)
  • samples/protobuf-sync-groovy-dsl/README.md: This examples shows how to generate -> This example shows

Notes for review

  • Two of the changes are inside clikt option help strings (--config-file and --flat-files), so they do change what gitquery --help prints. The README contains a pasted copy of that help output, and it has been updated in the same commit so the two stay byte-identical.
  • Deliberately left alone: buildSrc/src/main/kotlin/utlils.kt is misspelled, but renaming a file is out of scope for a typo fix. samples/sample2-generate-{flat,nested}.yml are generated YAML dumps, samples/.../AddressBookProtos.java is protobuf output, and the LICENSE header is untouched.
  • Unrelated observation, not changed: gradle-plugin/.../GitQueryInitExtension.kt initialises excludeGlobs from defaultIncludeGlobs rather than defaultExcludeGlobs, which looks like a copy-paste slip. That would be a behaviour change, so it is not part of this PR - flagging it in case it is a real bug.

No functional changes beyond the two CLI help strings noted above.

Signed-off-by: Léon Avic Simmons <Avicennasis@gmail.com>
@CLAassistant

CLAassistant commented Sep 7, 2026

Copy link
Copy Markdown

CLA assistant check
All committers have signed the CLA.

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