migrations icon indicating copy to clipboard operation
migrations copied to clipboard

Very poor documentation

Open ilyakaznacheev opened this issue 5 years ago • 6 comments

It would be great to add meaningful godoc comments and examples, document the ways the library can be used (how to use a different migration directory, how to register migrations from the code, etc.)

ilyakaznacheev avatar Apr 15 '19 21:04 ilyakaznacheev

I went through the md file and i didn't figure out how to do the migration. The example doesn't work at command "go run *.go" which i actually executed as "go run main.go". Poor documentation!

shawn246 avatar May 21 '20 09:05 shawn246

I want to help with this issue! I think a have understand the basics and simpler idea of how to explain it.

RegisMelgaco avatar Jan 14 '21 14:01 RegisMelgaco

I was thinking about creating a example/tutorial like the existing one. Any suggestions where to write it and which topics to cover?

RegisMelgaco avatar Jan 14 '21 14:01 RegisMelgaco

@RegisMelgaco if you ask me I would add an article to https://github.com/go-pg/docs/tree/master/docs. It will be published on https://pg.uptrace.dev/

But godoc comments or an example in this repo will be helpful too I guess :)

vmihailenco avatar Jan 19 '21 11:01 vmihailenco

Thanks for the tips! So I will prioritize writing the article, since it would be incorporated in the docs.

RegisMelgaco avatar Jan 19 '21 13:01 RegisMelgaco

Any updates on that? I can also help.

NivardoX avatar Apr 20 '21 21:04 NivardoX