[erlang-questions] erlang api documentation

[YC]

My 2 cents,

1) is Erlang documentation consumable?  i.e. XML or some other manipulatable
format.  If so, the user interface just need to be adequate.  People can
always import into their favorite doc browser or print.

2) Erlang's documentation is currently sparse, compared to perl, php,
python, etc.  A suggestion is to "open up" the documentation and have user
help improve that, like wiki style or comment style such as php/postgresql
(or there might be better ideas out there).


On 10/25/07, Frank Blecha <frank.blecha@REDACTED> wrote:
>
> Maybe we should refocus on documentation instead of javascript?
>
> On 10/25/07, Michael Campbell <michael.campbell@REDACTED > wrote:
> >
> > As a general rule I agree.  Links should be links.
> >
> > On 10/25/07, Daniel Luna < luna@REDACTED> wrote:
> > > On Wed, 24 Oct 2007, Kenneth Lundin wrote:
> > > > I have plans to improve the doc's in the direction you ask for. I am
> > > > also considering using Javascript in a similar way as used in the
> > > > previously mentioned http://gotapi.com. But I think it is still a
> > > > requirement that the doc's can be downloaded and browsed locally
> > without
> > > > the need for having a web-server running. I think it would be ok to
> > > > require a browser with javascript capabilities (we already require
> > > > javascript when it comes to links between applications)
> > >
> > > And this javascript is actually quite irritating for me. I quite often
> >
> > > wish to open links in a new tab, but when the link is a javscript
> > thingie
> > > I only get an empty tab when I middle-click.
> > >
> > > Please don't use them in the future version.
> > >
> > > /Luna
> > > --
> > > Daniel Luna                           | Top reasons that I have a
> > beard:
> > > luna@REDACTED                     |  a) Laziness.
> > > http://www.update.uu.se/~luna/ <http://www.update.uu.se/%7Eluna/>        |  b)
> > I can.
> > > Don't look at my homepage (it stinks).|  c) I can get away with it.
> > > _______________________________________________
> > > erlang-questions mailing list
> > > erlang-questions@REDACTED
> > > http://www.erlang.org/mailman/listinfo/erlang-questions
> > >
> > _______________________________________________
> > erlang-questions mailing list
> > erlang-questions@REDACTED
> > http://www.erlang.org/mailman/listinfo/erlang-questions
> >
>
>
>
> --
> Frank Blecha
>
> _______________________________________________
> erlang-questions mailing list
> erlang-questions@REDACTED
> http://www.erlang.org/mailman/listinfo/erlang-questions
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://erlang.org/pipermail/erlang-questions/attachments/20071025/31e82176/attachment.htm>