From e0ce0b54dfdf5df24df8d59374f2e579fa724c4f Mon Sep 17 00:00:00 2001 From: Kurt Jung Date: Sun, 12 Jul 2015 12:56:16 -0400 Subject: Add section on contributing changes to gofpdf --- README.md | 19 +++++++++++++++++++ doc.go | 22 ++++++++++++++++++++++ mkdoc | 5 +++++ 3 files changed, 46 insertions(+) diff --git a/README.md b/README.md index 352bbc3..aed9a5c 100644 --- a/README.md +++ b/README.md @@ -129,6 +129,25 @@ The [draw2d](https://github.com/llgcode/draw2d) package is a two dimensional vector graphics library that can generate output in different forms. It uses gofpdf for its document production mode. +##Contributing Changes + + +gofpdf is a global community effort and you are invited to make it even better. +If you have implmented a new feature or corrected a problem, please consider +contributing your change to the project. Here are guidelines for making +submissions. Your change should + +* be compatible with the MIT License +* be properly documented +* include an example in [fpdf_test.go](https://github.com/jung-kurt/gofpdf/blob/master/fpdf_test.go) if appropriate +* conform to the standards of [golint](https://github.com/golang/lint) and +[go vet](https://godoc.org/golang.org/x/tools/cmd/vet), that is, `golint .` and +`go vet .` should not generate any warnings +* not diminish [test coverage](https://blog.golang.org/cover) + +[Pull requests](https://help.github.com/articles/using-pull-requests/) work +nicely as a means of contributing your changes. + ##License diff --git a/doc.go b/doc.go index 818f434..86461ac 100644 --- a/doc.go +++ b/doc.go @@ -143,6 +143,28 @@ The draw2d package (https://github.com/llgcode/draw2d) is a two dimensional vector graphics library that can generate output in different forms. It uses gofpdf for its document production mode. +Contributing Changes + +gofpdf is a global community effort and you are invited to make it even better. +If you have implmented a new feature or corrected a problem, please consider +contributing your change to the project. Here are guidelines for making +submissions. Your change should + +• be compatible with the MIT License + +• be properly documented + +• include an example in fpdf_test.go if appropriate + +• conform to the standards of golint (https://github.com/golang/lint) and +go vet (https://godoc.org/golang.org/x/tools/cmd/vet), that is, `golint .` and +`go vet .` should not generate any warnings + +• not diminish test coverage (https://blog.golang.org/cover) + +Pull requests (https://help.github.com/articles/using-pull-requests/) work +nicely as a means of contributing your changes. + License gofpdf is released under the MIT License. It is copyrighted by Kurt Jung and diff --git a/mkdoc b/mkdoc index 8dd3850..301c39f 100755 --- a/mkdoc +++ b/mkdoc @@ -11,5 +11,10 @@ cat README.md | tr '\n' '\v' | sed \ -e 's/original.FPDF.library/original [FPDF](http:\/\/www.fpdf.org\/) library/g' \ -e 's/\(Effective.Go\)/[\1](https:\/\/golang.org\/doc\/effective_go.html)/g' \ -e 's/\(fpdf_test.go\)/[\1](https:\/\/github.com\/jung-kurt\/gofpdf\/blob\/master\/fpdf_test.go)/g' \ + -e 's/golint.(\(https:\/\/github\.com\/golang\/lint\))/[golint](\1)/g' \ + -e 's/go.vet.(\(https:\/\/godoc\.org\/golang\.org\/x\/tools\/cmd\/vet\))/[go vet](\1)/g' \ + -e 's/test.coverage.(\(https:\/\/blog\.golang\.org\/cover\))/[test coverage](\1)/g' \ + -e 's/Pull.requests.(\(https:\/\/help\.github\.com\/articles\/using\-pull\-requests\/\))/[Pull requests](\1)/g' \ + -e 's/Your change should\v/Your change should\v\v/g' \ | tr '\v' '\n' > 0 mv 0 README.md -- cgit v1.2.1-24-ge1ad