Skip to content

Expert Opinion: godoc and godoc.org need a rethink #5107

@gopherbot

Description

@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

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions