Expert Opinion: godoc and godoc.org need a rethink

[gopherbot]

by pedromorgan:

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

[adg]

Comment 1:

This is incomprehensible.

Status changed to Invalid.

[adg]

Comment 2:

Maybe you should read this?
http://blog.golang.org/2011/03/godoc-documenting-go-code.html