Skip to content

Commit

Permalink
#69 migrate from g2 to sz/er
Browse files Browse the repository at this point in the history
  • Loading branch information
docktermj committed Aug 20, 2024
1 parent daa32d0 commit 4146576
Show file tree
Hide file tree
Showing 4 changed files with 43 additions and 83 deletions.
6 changes: 6 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0

## [Unreleased]

## [0.3.0] - 2024-08-20

### Changed in 0.3.0

- Change from `g2` to `sz`/`er`

## [0.2.2] - 2024-06-12

### Changed in 0.2.2
Expand Down
65 changes: 33 additions & 32 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,9 +16,7 @@ the recommendation is not to use it yet.

## Synopsis

`explain` is a command in the
[senzing-tools](https://github.com/senzing-garage/senzing-tools)
suite of tools.
`explain` is a command in the [senzing-tools] suite of tools.
It is used to explain aspects of `senzing-tools`.

[![Go Reference Badge]][Package reference]
Expand All @@ -43,10 +41,8 @@ It is used to explain aspects of `senzing-tools`.

## Install

1. The `explain` command is installed with the
[senzing-tools](https://github.com/senzing-garage/senzing-tools)
suite of tools.
See senzing-tools [install](https://github.com/senzing-garage/senzing-tools#install).
1. The `explain` command is installed with the [senzing-tools] suite of tools.
See [senzing-tools install].

## Use

Expand All @@ -56,15 +52,15 @@ senzing-tools explain [flags]
```

1. For options and flags:
1. [Online documentation](https://hub.senzing.com/senzing-tools/senzing-tools_explain.html)
1. [Online documentation]
1. Runtime documentation:

```console
export LD_LIBRARY_PATH=/opt/senzing/er/lib/
senzing-tools explain --help
```

1. In addition to the following simple usage examples, there are additional [Examples](docs/examples.md).
1. In addition to the following simple usage examples, there are additional [Examples].

### Using command line options

Expand All @@ -76,7 +72,7 @@ senzing-tools explain [flags]
senzing-tools explain
```

1. See [Parameters](#parameters) for additional parameters.
1. See [Parameters] for additional parameters.

### Using environment variables

Expand All @@ -89,14 +85,14 @@ senzing-tools explain [flags]
senzing-tools explain
```

1. See [Parameters](#parameters) for additional parameters.
1. See [Parameters] for additional parameters.

### Parameters

- **[LD_LIBRARY_PATH](https://github.com/senzing-garage/knowledge-base/blob/main/lists/environment-variables.md#ld_library_path)**
- **[SENZING_TOOLS_COMMAND](https://github.com/senzing-garage/knowledge-base/blob/main/lists/environment-variables.md#senzing_tools_command)**
- **[SENZING_TOOLS_MESSAGE_ID](https://github.com/senzing-garage/knowledge-base/blob/main/lists/environment-variables.md#senzing_tools_message_id)**
- **[SENZING_TOOLS_TTY_ONLY](https://github.com/senzing-garage/knowledge-base/blob/main/lists/environment-variables.md#senzing_tools_tty_only)**
- **[LD_LIBRARY_PATH]**
- **[SENZING_TOOLS_COMMAND]**
- **[SENZING_TOOLS_MESSAGE_ID]**
- **[SENZING_TOOLS_TTY_ONLY]**

## References

Expand All @@ -105,28 +101,33 @@ senzing-tools explain [flags]
1. [Errors]
1. [Examples]
1. [Package reference]
1. Related artifacts:
1. [DockerHub]

[API documentation]: https://pkg.go.dev/github.com/senzing-garage/template-go
[API documentation]: https://pkg.go.dev/github.com/senzing-garage/explain
[Development]: docs/development.md
[DockerHub]: https://hub.docker.com/r/senzing/template-go
[Errors]: docs/errors.md
[Examples]: docs/examples.md
[Go Reference Badge]: https://pkg.go.dev/badge/github.com/senzing-garage/template-go.svg
[Go Report Card Badge]: https://goreportcard.com/badge/github.com/senzing-garage/template-go
[Go Report Card]: https://goreportcard.com/report/github.com/senzing-garage/template-go
[go-test-darwin.yaml Badge]: https://github.com/senzing-garage/template-go/actions/workflows/go-test-darwin.yaml/badge.svg
[go-test-darwin.yaml]: https://github.com/senzing-garage/template-go/actions/workflows/go-test-darwin.yaml
[go-test-linux.yaml Badge]: https://github.com/senzing-garage/template-go/actions/workflows/go-test-linux.yaml/badge.svg
[go-test-linux.yaml]: https://github.com/senzing-garage/template-go/actions/workflows/go-test-linux.yaml
[go-test-windows.yaml Badge]: https://github.com/senzing-garage/template-go/actions/workflows/go-test-windows.yaml/badge.svg
[go-test-windows.yaml]: https://github.com/senzing-garage/template-go/actions/workflows/go-test-windows.yaml
[golangci-lint.yaml Badge]: https://github.com/senzing-garage/template-go/actions/workflows/golangci-lint.yaml/badge.svg
[golangci-lint.yaml]: https://github.com/senzing-garage/template-go/actions/workflows/golangci-lint.yaml
[Go Reference Badge]: https://pkg.go.dev/badge/github.com/senzing-garage/explain.svg
[Go Report Card Badge]: https://goreportcard.com/badge/github.com/senzing-garage/explain
[Go Report Card]: https://goreportcard.com/report/github.com/senzing-garage/explain
[go-test-darwin.yaml Badge]: https://github.com/senzing-garage/explain/actions/workflows/go-test-darwin.yaml/badge.svg
[go-test-darwin.yaml]: https://github.com/senzing-garage/explain/actions/workflows/go-test-darwin.yaml
[go-test-linux.yaml Badge]: https://github.com/senzing-garage/explain/actions/workflows/go-test-linux.yaml/badge.svg
[go-test-linux.yaml]: https://github.com/senzing-garage/explain/actions/workflows/go-test-linux.yaml
[go-test-windows.yaml Badge]: https://github.com/senzing-garage/explain/actions/workflows/go-test-windows.yaml/badge.svg
[go-test-windows.yaml]: https://github.com/senzing-garage/explain/actions/workflows/go-test-windows.yaml
[golangci-lint.yaml Badge]: https://github.com/senzing-garage/explain/actions/workflows/golangci-lint.yaml/badge.svg
[golangci-lint.yaml]: https://github.com/senzing-garage/explain/actions/workflows/golangci-lint.yaml
[LD_LIBRARY_PATH]: https://github.com/senzing-garage/knowledge-base/blob/main/lists/environment-variables.md#ld_library_path
[License Badge]: https://img.shields.io/badge/License-Apache2-brightgreen.svg
[License]: https://github.com/senzing-garage/template-go/blob/main/LICENSE
[Package reference]: https://pkg.go.dev/github.com/senzing-garage/template-go
[License]: https://github.com/senzing-garage/explain/blob/main/LICENSE
[Online documentation]: https://hub.senzing.com/senzing-tools/senzing-tools_explain.html
[Package reference]: https://pkg.go.dev/github.com/senzing-garage/explain
[Parameters]: #parameters
[Senzing Garage]: https://github.com/senzing-garage
[Senzing Quick Start guides]: https://docs.senzing.com/quickstart/
[SENZING_TOOLS_COMMAND]: https://github.com/senzing-garage/knowledge-base/blob/main/lists/environment-variables.md#senzing_tools_command
[SENZING_TOOLS_MESSAGE_ID]: https://github.com/senzing-garage/knowledge-base/blob/main/lists/environment-variables.md#senzing_tools_message_id
[SENZING_TOOLS_TTY_ONLY]: https://github.com/senzing-garage/knowledge-base/blob/main/lists/environment-variables.md#senzing_tools_tty_only
[senzing-tools install]: https://github.com/senzing-garage/senzing-tools#install
[senzing-tools]: https://github.com/senzing-garage/senzing-tools
[Senzing]: https://senzing.com/
48 changes: 0 additions & 48 deletions doc.go
Original file line number Diff line number Diff line change
@@ -1,52 +1,4 @@
/*
One or two sentence synopsys of the module. The Senzing XXXX module is...
# Overview
One or two paragraph overview of this module...
(This page describes the nature of the entire Go module or the top-level command, not an individual package.)
More information at https://github.com/senzing-garage/explain
# Example Package
The example package gives an example layout for a package. This includes how
documentation, tests, and examples should be done. This paragraph (or two)
should provide a brief overview while linking the reader to the documentation
included in the package itself.
More information can be found in the [pkg/github.com/senzing-garage/explain/examplepackage] documentation.
# Another Header: Package or other module features...
More details about the module...
Lorem ipsum dolor sit amet, consectetur adipiscing elit...
# Examples
The examples given here should show a holistic view of the module, if appropriate.
Examples of use can be seen in the main_test.go files.
package main
import (
fmt
"github.com/senzing-garage/explain/examplepackage"
"github.com/senzing-garage/explain/anotherpackage"
)
func main() {
ctx := context.TODO()
testObject := &ExamplePackageImpl{
Something: "I'm here",
}
err := testObject.SaySomething(ctx)
if err != nil {
fmt.Println("whoops")
}
anotherpackage.DoSomething(ctx)...
}
*/
package main
7 changes: 4 additions & 3 deletions docs/development.md
Original file line number Diff line number Diff line change
Expand Up @@ -183,6 +183,7 @@ Example:
make clean

```

## Package

### Package RPM and DEB files
Expand Down Expand Up @@ -244,10 +245,10 @@ Example:
[clone-repository]: https://github.com/senzing-garage/knowledge-base/blob/main/HOWTO/clone-repository.md
[docker]: https://github.com/senzing-garage/knowledge-base/blob/main/WHATIS/docker.md
[git]: https://github.com/senzing-garage/knowledge-base/blob/main/WHATIS/git.md
[Go Reference Badge]: https://pkg.go.dev/badge/github.com/senzing-garage/template-go.svg
[Go Reference]: https://pkg.go.dev/github.com/senzing-garage/template-go
[Go Reference Badge]: https://pkg.go.dev/badge/github.com/senzing-garage/explain.svg
[Go Reference]: https://pkg.go.dev/github.com/senzing-garage/explain
[go]: https://github.com/senzing-garage/knowledge-base/blob/main/WHATIS/go.md
[How to Install Senzing for Go Development]: https://github.com/senzing-garage/knowledge-base/blob/main/HOWTO/install-senzing-for-go-development.md
[localhost:6060]: http://localhost:6060/pkg/github.com/senzing-garage/template-go/
[localhost:6060]: http://localhost:6060/pkg/github.com/senzing-garage/explain/
[make]: https://github.com/senzing-garage/knowledge-base/blob/main/WHATIS/make.md
[testcoverage.yaml]: ../.github/coverage/testcoverage.yaml

0 comments on commit 4146576

Please sign in to comment.