mirror of https://github.com/mikefarah/yq.git synced 2024-11-13 22:38:04 +00:00

* Remove extra backtick

* Reword explanation of update

* Reword explanation of relative update

* Change "remaple" to "remain"

* Change "clovver" to "clobber"

* Reword explanation of update for comment operators

* Reword explanation of relative update for comment operators

* Change "array" to "expression"

* Change "the golangs" to "Golang's"

* Change "golangs" to "Golang's"

* Change "can durations" to "can add durations"

* Change "array scalars" to "arrays"

* Change "beit" to "be it"

* Fix typo in `eval` tip

* Fix typo in header for `has` operation

* Add space before pipe in `line` operator example

* Fix typos in explanation of deep array merges

* Change "is now used" to "is now used."

* Change "object," to "object."

* Changes "indexes" to "indices"

* Remove extraneous copied text from `..` article

* Reword explanation of `...` operator

* Change "your are" to "you are"

* Add link to `string` operator docs in `select` article

* Change "is a" to "parameter specifies" in `string` operators article

* Change "new line" to "newline"

* Change "golang regex" to "Golang's regex"

* Change "golang" to "Golang"

* Add period

* Remove comma in `subtract` article

* Remove duplicate number subtraction example

* Remove comma in `traverse` operator article

* Clarify use of brackets when `read`ing with special characters

2023-03-16 13:39:36 +11:00

2.4 KiB

Raw Blame History

Development

Install (Golang)[https://golang.org/]
Run scripts/devtools.sh to install the required devtools
Run make [local] vendor to install the vendor dependencies
Run make [local] test to ensure you can run the existing tests
Write unit tests - (see existing examples). Changes will not be accepted without corresponding unit tests.
Make the code changes.
make [local] test to lint code and run tests
Profit! ok no profit, but raise a PR and get kudos :)

Documentation

The documentation is a bit of a mixed bag (sorry in advanced, I do plan on simplifying it...) - with some parts automatically generated and stiched together and some statically defined.

Documentation is written in markdown, and is published in the 'gitbook' branch.

The various operator documentation (e.g. 'strings') are generated from the 'master' branch, and have a statically defined header (e.g. pkg/yqlib/doc/operators/headers/add.md) and the bulk of the docs are generated from the unit tests e.g. pkg/yqlib/operator_add_test.go.

The pipeline will run the tests and automatically concatenate the files together, and put them under pkg/qylib/doc/add.md. These files are checked in the master branch (and are copied to the gitbook branch as part of the release process).

How to contribute

The first step is to find if what you want is automatically generated or not - start by looking in the master branch.

Updating dynamic documentation from master

Search for the documentation you want to update. If you find matches in a *_test.go file - update that, as that will automatically update the matching *.md file
Assuming you are updating a *_test.go file, once updated, run the test to regenerated the docs. E.g. for the 'Add' test generated docs, from the pkg/yqlib folder run: go test -run TestAddOperatorScenarios which will run that test defined in the operator_add_test.go file.
Ensure the tests still pass, and check the generated documentation have your update.
Note: If the documentation is only in a headers/*.md file, then just update that directly
Raise a PR to merge the changes into master!

Updating static documentation from the gitbook branch

If you haven't found what you want to update in the master branch, then check the gitbook branch directly as there are a few pages in there that are not in master.

Update the *.md files
Raise a PR to merge the changes into gitbook.