Join GitHub today
GitHub is home to over 40 million developers working together to host and review code, manage projects, and build software together.Sign up
Expert Opinion: godoc and godoc.org need a rethink #5107
Ok ok lets put a nil into things we dont have to do it like First question for any coder.. Is that all we want to do is explain bits of code, and its runningz what it does.. Hopefully there is a lot of coders looking at it cos we can auto gen documentation.. Now there are a few ways to do this.. The first concept is to.. For the doco manager is to create the file that explain and do things and a manual The nexxt concept is to interlink into stuff What developers want ? NOrmally the developer is do busy coding u have to interupt It whet I better explain how this works and all langs work different ways Java /* Is Documentated */ this( What GoLand should be Is a simple commentrty and link Aas we gonna use gomang.org aaas our voerifier.. Si all the comment we spend our tiimes will come into fuitiion We expectsimple markup eg /* This IS IT */ Its pissing me off bigtimer.. I waanna wrie code
Maybe you should read this? http://blog.golang.org/2011/03/godoc-documenting-go-code.html
This issue was closed.