Skip to content

Commit

Permalink
#180 Add documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
docktermj committed Aug 23, 2024
1 parent 889c9a8 commit 818fc5e
Show file tree
Hide file tree
Showing 6 changed files with 63 additions and 19 deletions.
18 changes: 11 additions & 7 deletions doc.go
Original file line number Diff line number Diff line change
@@ -1,19 +1,23 @@
/*
Module sz-sdk-go-grpc communicates over a network using gRPC to the Senzing's C-based library.
Module sz-sdk-go-grpc is used to communicate over a network using gRPC to a Senzing gRPC server.
# Overview
The Senzing sz-sdk-go-grpc packages enable Go programs to call Senzing library functions over a network.
Under the covers, gRPC is used as the protocol to communicate with a Senzing gRPC server.
More information:
- Senzing gRPC server: https://github.com/senzing-garage/serve-grpc
- Senzing Go SDK API definitions: https://github.com/senzing-garage/sz-sdk-go
- Senzing Protobuf definitions: https://github.com/senzing-garage/sz-sdk-proto
# Examples
Examples of use can be seen in the xxxx_test.go files.
# Related information
- [Senzing gRPC server]
- [Senzing Go SDK API definitions]
- [Senzing Protobuf definitions]
[Senzing gRPC server]: https://github.com/senzing-garage/serve-grpc
[Senzing Go SDK API definitions]: https://github.com/senzing-garage/sz-sdk-go
[Senzing Protobuf definitions]: https://github.com/senzing-garage/sz-sdk-proto
*/
package main
14 changes: 11 additions & 3 deletions szconfig/doc.go
Original file line number Diff line number Diff line change
@@ -1,6 +1,14 @@
/*
Package szconfig is used to modify the in-memory representation of a Senzing configuration.
The gRPC definitions are at https://github.com/senzing-garage/sz-sdk-proto.
The Senzing gRPC server is at https://github.com/senzing-garage/serve-grpc.
Package szconfig is used make SzConfig requests to a Senzing gRPC server.
# Related information
- [Senzing gRPC server]
- [Senzing Go SDK API definitions]
- [Senzing Protobuf definitions]
[Senzing gRPC server]: https://github.com/senzing-garage/serve-grpc
[Senzing Go SDK API definitions]: https://github.com/senzing-garage/sz-sdk-go
[Senzing Protobuf definitions]: https://github.com/senzing-garage/sz-sdk-proto
*/
package szconfig
14 changes: 11 additions & 3 deletions szconfigmanager/doc.go
Original file line number Diff line number Diff line change
@@ -1,6 +1,14 @@
/*
Package Szconfigmanager is used make SzConfigManager requests to a Senzing gRPC server.
The gRPC definitions are at https://github.com/senzing-garage/sz-sdk-proto.
The Senzing gRPC server is at https://github.com/senzing-garage/serve-grpc.
Package szconfigmanager is used make SzConfigManager requests to a Senzing gRPC server.
# Related information
- [Senzing gRPC server]
- [Senzing Go SDK API definitions]
- [Senzing Protobuf definitions]
[Senzing gRPC server]: https://github.com/senzing-garage/serve-grpc
[Senzing Go SDK API definitions]: https://github.com/senzing-garage/sz-sdk-go
[Senzing Protobuf definitions]: https://github.com/senzing-garage/sz-sdk-proto
*/
package szconfigmanager
12 changes: 10 additions & 2 deletions szdiagnostic/doc.go
Original file line number Diff line number Diff line change
@@ -1,6 +1,14 @@
/*
Package szdiagnostic is used make SzDiagnostic requests to a Senzing gRPC server.
The gRPC definitions are at https://github.com/senzing-garage/sz-sdk-proto.
The Senzing gRPC server is at https://github.com/senzing-garage/serve-grpc.
# Related information
- [Senzing gRPC server]
- [Senzing Go SDK API definitions]
- [Senzing Protobuf definitions]
[Senzing gRPC server]: https://github.com/senzing-garage/serve-grpc
[Senzing Go SDK API definitions]: https://github.com/senzing-garage/sz-sdk-go
[Senzing Protobuf definitions]: https://github.com/senzing-garage/sz-sdk-proto
*/
package szdiagnostic
12 changes: 10 additions & 2 deletions szengine/doc.go
Original file line number Diff line number Diff line change
@@ -1,6 +1,14 @@
/*
Package szengine is used make SzEngine requests to a Senzing gRPC server.
The gRPC definitions are at https://github.com/senzing-garage/sz-sdk-proto.
The Senzing gRPC server is at https://github.com/senzing-garage/serve-grpc.
# Related information
- [Senzing gRPC server]
- [Senzing Go SDK API definitions]
- [Senzing Protobuf definitions]
[Senzing gRPC server]: https://github.com/senzing-garage/serve-grpc
[Senzing Go SDK API definitions]: https://github.com/senzing-garage/sz-sdk-go
[Senzing Protobuf definitions]: https://github.com/senzing-garage/sz-sdk-proto
*/
package szengine
12 changes: 10 additions & 2 deletions szproduct/doc.go
Original file line number Diff line number Diff line change
@@ -1,6 +1,14 @@
/*
Package szproduct is used make SzProduct requests to a Senzing gRPC server.
The gRPC definitions are at https://github.com/senzing-garage/sz-sdk-proto.
The Senzing gRPC server is at https://github.com/senzing-garage/serve-grpc.
# Related information
- [Senzing gRPC server]
- [Senzing Go SDK API definitions]
- [Senzing Protobuf definitions]
[Senzing gRPC server]: https://github.com/senzing-garage/serve-grpc
[Senzing Go SDK API definitions]: https://github.com/senzing-garage/sz-sdk-go
[Senzing Protobuf definitions]: https://github.com/senzing-garage/sz-sdk-proto
*/
package szproduct

0 comments on commit 818fc5e

Please sign in to comment.