<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML xmlns="http://www.w3.org/TR/REC-html40" xmlns:v =
"urn:schemas-microsoft-com:vml" xmlns:o =
"urn:schemas-microsoft-com:office:office" xmlns:w =
"urn:schemas-microsoft-com:office:word"><HEAD>
<META http-equiv=Content-Type content="text/html; charset=us-ascii">
<META content="MSHTML 6.00.2800.1528" name=GENERATOR><!--[if !mso]>
<STYLE>v\:* {
BEHAVIOR: url(#default#VML)
}
o\:* {
BEHAVIOR: url(#default#VML)
}
w\:* {
BEHAVIOR: url(#default#VML)
}
.shape {
BEHAVIOR: url(#default#VML)
}
</STYLE>
<![endif]-->
<STYLE>@font-face {
font-family: Tahoma;
}
@page Section1 {size: 8.5in 11.0in; margin: 1.0in 1.25in 1.0in 1.25in; }
P.MsoNormal {
FONT-SIZE: 12pt; MARGIN: 0in 0in 0pt; FONT-FAMILY: "Times New Roman"
}
LI.MsoNormal {
FONT-SIZE: 12pt; MARGIN: 0in 0in 0pt; FONT-FAMILY: "Times New Roman"
}
DIV.MsoNormal {
FONT-SIZE: 12pt; MARGIN: 0in 0in 0pt; FONT-FAMILY: "Times New Roman"
}
A:link {
COLOR: blue; TEXT-DECORATION: underline
}
SPAN.MsoHyperlink {
COLOR: blue; TEXT-DECORATION: underline
}
A:visited {
COLOR: purple; TEXT-DECORATION: underline
}
SPAN.MsoHyperlinkFollowed {
COLOR: purple; TEXT-DECORATION: underline
}
SPAN.EmailStyle17 {
COLOR: windowtext; FONT-FAMILY: Arial; mso-style-type: personal
}
SPAN.EmailStyle18 {
COLOR: navy; FONT-FAMILY: Arial; mso-style-type: personal-reply
}
DIV.Section1 {
page: Section1
}
OL {
MARGIN-BOTTOM: 0in
}
UL {
MARGIN-BOTTOM: 0in
}
</STYLE>
<!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]--></HEAD>
<BODY lang=EN-US vLink=purple link=blue>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff
size=2>Martin,</FONT></SPAN></DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff
size=2></FONT></SPAN> </DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff size=2>I
don't like the idea of you editing my tutorials - but I do like the idea of you
defining and maintaining</FONT></SPAN></DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff size=2>the
guidelines and tools for producing tutorials.</FONT></SPAN></DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff
size=2></FONT></SPAN> </DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff size=2>If you
edit my tutorials you could introduce errors, and use formatting that I think
detracts from the text,</FONT></SPAN></DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff size=2>and I
just don't want this to happen.</FONT></SPAN></DIV>
<DIV><SPAN class=593234107-21082006></SPAN><FONT face=Arial><FONT size=2><FONT
color=#0000ff> </FONT></FONT></FONT></DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff size=2>I'm
sorry, but I just do not want other people editing my texts and republishing
them.</FONT></SPAN></DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff
size=2></FONT></SPAN> </DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff size=2>I do
not like the model "anybody can edit this text" but I do like the model "only
authors</FONT></SPAN></DIV>
<DIV><FONT face=Arial><FONT size=2><FONT color=#0000ff><SPAN
class=593234107-21082006>can </SPAN><SPAN class=593234107-21082006>edit the
text" and anybody can comment.</SPAN></FONT></FONT></FONT></DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff
size=2></FONT></SPAN> </DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff
size=2><< the system I and Uff are making will be exactly like this - only
authors can edit text,</FONT></SPAN></DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff
size=2>non-authors will be able to add questions to the text (these will be
formatted as a single non-obtrusive</FONT></SPAN></DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff
size=2>question mark in the text flow) - when you mouse hover over the question
mark you will get</FONT></SPAN></DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff size=2>see
the question - anybody can answer, the answer will go into the hover box)
>></FONT></SPAN></DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff
size=2></FONT></SPAN> </DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff size=2>If you
provide a standard and tell people "follow this standard" then I will happily
comply - *if I like the standard*</FONT></SPAN></DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff
size=2></FONT></SPAN> </DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff size=2>The
original trap-exit site how to's which used the gentoo document dtd's were a
great step in the right direction.</FONT></SPAN></DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff
size=2></FONT></SPAN> </DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff size=2>IMHO -
is is critical that the documentation format is fixed, frozen and
well-defined - so that tools can be</FONT></SPAN></DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff
size=2>written to automatically digest and reprocess the inputs. Vanilla HTML
etc is just not good enough.</FONT></SPAN></DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff size=2>I
think the only possible alternative is properly validated XML (we could have
used SGML, but maintaining the</FONT></SPAN></DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff size=2>tool
chains is becoming bothersome) with an appropriate
DTD. </FONT></SPAN></DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff
size=2></FONT></SPAN> </DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff size=2>The
next point concerns the stability of the site - the next time we move the
documentation we want to</FONT></SPAN></DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff size=2>move
to a URL that stays fixed for a long time - previous attempts to do this have
always failed.</FONT></SPAN></DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff
size=2></FONT></SPAN> </DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff size=2>To
solve both these problems I would like to suggest the
following:</FONT></SPAN></DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff
size=2></FONT></SPAN> </DIV>
<DIV><SPAN class=593234107-21082006> <FONT face=Arial
color=#0000ff size=2>1. We store the tutorials as static content (ie no mysql,
php, yaws ... in the background :)</FONT></SPAN></DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff
size=2> with no wiki's etc to allow
editing (you could point to an off-site wiki for discussions
etc)</FONT></SPAN></DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff
size=2></FONT></SPAN> </DIV>
<DIV><SPAN class=593234107-21082006> <FONT face=Arial
color=#0000ff size=2>2. We have a single master site and a number of mirrors for
the entire site</FONT></SPAN></DIV>
<DIV><SPAN class=593234107-21082006> <FONT face=Arial
color=#0000ff size=2> - so we need volunteers for
mirrors, and a volunteer for the master site</FONT></SPAN></DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff
size=2></FONT></SPAN> </DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff
size=2> 3. We use the gentoo documentation tool
chain</FONT></SPAN></DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff
size=2> <A
href="http://www.gentoo.org/proj/en/gdp/doc/doc-tipsntricks.xml">http://www.gentoo.org/proj/en/gdp/doc/doc-tipsntricks.xml</A></FONT></SPAN></DIV>
<DIV><SPAN class=593234107-21082006> </SPAN></DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff size=2>In
addition we need a website and some administration around all of this - so I
guess a version (-1) </FONT></SPAN></DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff size=2>is
just a simple list of pointers to tutorials.</FONT></SPAN></DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff
size=2></FONT></SPAN> </DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff size=2>Here
are some tutorials I have written</FONT></SPAN></DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff
size=2></FONT></SPAN> </DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff size=2><A
href="http://www.sics.se/~joe/tutorials/robust_server/robust_server.html">http://www.sics.se/~joe/tutorials/robust_server/robust_server.html</A></FONT></SPAN></DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff size=2><A
href="http://www.sics.se/~joe/tutorials/web_server/web_server.html">http://www.sics.se/~joe/tutorials/web_server/web_server.html</A></FONT></SPAN></DIV>
<DIV><A
href="http://www.sics.se/~joe/tutorials/client_server/client_server.html"><FONT
face=Arial
size=2>http://www.sics.se/~joe/tutorials/client_server/client_server.html</FONT></A><FONT
face=Arial><FONT color=#0000ff><FONT size=2> </FONT></FONT></FONT></DIV>
<DIV><FONT face=Arial color=#0000ff size=2><A
href="http://www.sics.se/~joe/tutorials/wiki/wiki.html">http://www.sics.se/~joe/tutorials/wiki/wiki.html</A></FONT></DIV>
<DIV><FONT face=Arial color=#0000ff size=2></FONT><FONT face=Arial color=#0000ff
size=2><A
href="http://www.erlang.org/faq/parsing.html">http://www.erlang.org/faq/parsing.html</A></FONT></DIV>
<DIV><FONT face=Arial color=#0000ff size=2><A
href="http://www.erlang.org/examples/examples-2.0.html">http://www.erlang.org/examples/examples-2.0.html</A></FONT></DIV>
<DIV><FONT face=Arial color=#0000ff size=2></FONT><FONT face=Arial color=#0000ff
size=2><A
href="http://www.erlang.org/examples/win95demo/win95demo.html">http://www.erlang.org/examples/win95demo/win95demo.html</A></FONT></DIV>
<DIV><FONT face=Arial color=#0000ff size=2></FONT><FONT face=Arial color=#0000ff
size=2></FONT><FONT face=Arial color=#0000ff size=2></FONT><FONT face=Arial
color=#0000ff size=2></FONT> </DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff size=2>Now I
will happily convert these to the gentoo format (If this is what we decide to
do)</FONT></SPAN></DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff size=2>And I
will happily allow you to reference these. But I do not wish you to reformat
these in any</FONT></SPAN></DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff size=2>way
without my explicit permission.</FONT></SPAN></DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff
size=2></FONT></SPAN> </DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff
size=2>/Joe</FONT></SPAN></DIV>
<DIV><SPAN class=593234107-21082006><FONT face=Arial color=#0000ff
size=2></FONT></SPAN> </DIV>
<DIV><BR></DIV>
<BLOCKQUOTE dir=ltr
style="PADDING-LEFT: 5px; MARGIN-LEFT: 5px; BORDER-LEFT: #0000ff 2px solid; MARGIN-RIGHT: 0px">
<DIV class=OutlookMessageHeader lang=en-us dir=ltr align=left>
<HR tabIndex=-1>
<FONT face=Tahoma size=2><B>From:</B> owner-erlang-questions@erlang.org
[mailto:owner-erlang-questions@erlang.org] <B>On Behalf Of </B>Logan,
Martin<BR><B>Sent:</B> den 17 augusti 2006 19:29<BR><B>To:</B>
erlang-questions@erlang.org<BR><B>Subject:</B> RE:
Tutorials<BR></FONT><BR></DIV>
<DIV></DIV>
<DIV class=Section1>
<P class=MsoNormal><FONT face=Arial color=navy size=2><SPAN
style="FONT-SIZE: 10pt; COLOR: navy; FONT-FAMILY: Arial">I have gotten a few
responses with some good ideas. I think that this can be a community
effort and still get done quickly and completely. Here are the steps I
think would be best for getting this accomplished –
fast<o:p></o:p></SPAN></FONT></P>
<P class=MsoNormal><FONT face=Arial color=navy size=2><SPAN
style="FONT-SIZE: 10pt; COLOR: navy; FONT-FAMILY: Arial"><o:p> </o:p></SPAN></FONT></P>
<OL style="MARGIN-TOP: 0in" type=1>
<LI class=MsoNormal style="COLOR: navy; mso-list: l0 level1 lfo1"><FONT
face=Arial color=navy size=2><SPAN
style="FONT-SIZE: 10pt; FONT-FAMILY: Arial">Send to the list, this thread,
any and all links to tutorials that exist<o:p></o:p></SPAN></FONT>
<LI class=MsoNormal style="COLOR: navy; mso-list: l0 level1 lfo1"><FONT
face=Arial color=navy size=2><SPAN
style="FONT-SIZE: 10pt; FONT-FAMILY: Arial">When the posting slows down I
will extract a list of links from the thread and someone from trap exit or
the erlang wiki can take the time to put them on the
website.<o:p></o:p></SPAN></FONT>
<LI class=MsoNormal style="COLOR: navy; mso-list: l0 level1 lfo1"><FONT
face=Arial color=navy size=2><SPAN
style="FONT-SIZE: 10pt; FONT-FAMILY: Arial">Start a new thread on
suggestions, and hopefully examples, for the layout and structure of the
tutorials – I like the format from trap exit and I also like the erlang docs
site. <o:p></o:p></SPAN></FONT>
<LI class=MsoNormal style="COLOR: navy; mso-list: l0 level1 lfo1"><FONT
face=Arial color=navy size=2><SPAN
style="FONT-SIZE: 10pt; FONT-FAMILY: Arial">Use the wiki to allow people to
sign up for tutorials to format - I will volunteer right now to do many of
them.<o:p></o:p></SPAN></FONT>
<LI class=MsoNormal style="COLOR: navy; mso-list: l0 level1 lfo1"><FONT
face=Arial color=navy size=2><SPAN
style="FONT-SIZE: 10pt; FONT-FAMILY: Arial">Post the final copies on erlang
websites all over the net, but have a versioned master copy somewhere for
easy updating. <o:p></o:p></SPAN></FONT> </LI></OL>
<P class=MsoNormal><FONT face=Arial color=navy size=2><SPAN
style="FONT-SIZE: 10pt; COLOR: navy; FONT-FAMILY: Arial"><o:p> </o:p></SPAN></FONT></P>
<P class=MsoNormal><FONT face=Arial color=navy size=2><SPAN
style="FONT-SIZE: 10pt; COLOR: navy; FONT-FAMILY: Arial">Thoughts,
comments...?<o:p></o:p></SPAN></FONT></P>
<P class=MsoNormal><FONT face=Arial color=navy size=2><SPAN
style="FONT-SIZE: 10pt; COLOR: navy; FONT-FAMILY: Arial"><o:p> </o:p></SPAN></FONT></P>
<P class=MsoNormal><FONT face=Arial color=navy size=2><SPAN
style="FONT-SIZE: 10pt; COLOR: navy; FONT-FAMILY: Arial">Cheers,<o:p></o:p></SPAN></FONT></P>
<P class=MsoNormal><FONT face=Arial color=navy size=2><SPAN
style="FONT-SIZE: 10pt; COLOR: navy; FONT-FAMILY: Arial">Martin<o:p></o:p></SPAN></FONT></P>
<P class=MsoNormal><FONT face=Arial color=navy size=2><SPAN
style="FONT-SIZE: 10pt; COLOR: navy; FONT-FAMILY: Arial"><o:p> </o:p></SPAN></FONT></P>
<DIV>
<DIV class=MsoNormal style="TEXT-ALIGN: center" align=center><FONT
face="Times New Roman" size=3><SPAN style="FONT-SIZE: 12pt">
<HR tabIndex=-1 align=center width="100%" SIZE=3>
</SPAN></FONT></DIV>
<P class=MsoNormal><B><FONT face=Tahoma size=2><SPAN
style="FONT-WEIGHT: bold; FONT-SIZE: 10pt; FONT-FAMILY: Tahoma">From:</SPAN></FONT></B><FONT
face=Tahoma size=2><SPAN style="FONT-SIZE: 10pt; FONT-FAMILY: Tahoma">
owner-erlang-questions@erlang.org [mailto:owner-erlang-questions@erlang.org]
<B><SPAN style="FONT-WEIGHT: bold">On Behalf Of </SPAN></B>Logan,
Martin<BR><B><SPAN style="FONT-WEIGHT: bold">Sent:</SPAN></B> Thursday, August
17, 2006 9:29 AM<BR><B><SPAN style="FONT-WEIGHT: bold">To:</SPAN></B>
erlang-questions@erlang.org<BR><B><SPAN
style="FONT-WEIGHT: bold">Subject:</SPAN></B>
Tutorials</SPAN></FONT><o:p></o:p></P></DIV>
<P class=MsoNormal><FONT face="Times New Roman" size=3><SPAN
style="FONT-SIZE: 12pt"><o:p> </o:p></SPAN></FONT></P>
<P class=MsoNormal><FONT face=Arial size=2><SPAN
style="FONT-SIZE: 10pt; FONT-FAMILY: Arial">All, I would like to collect and
format all the existing tutorials for erlang/otp. I would like anyone
that has written a tutorial about anything to please forward it to me or the
list. I am going to endeavor to format them, perhaps copy the style of
the erlang docs, but I am not positive, and then make them available. I
will credit the authors of course. I think it would be helpful for new
people coming to the language to have a nice compendium of tutorials.
You can forward me the tutorials in any form and I will do the work to
get them all formatted nicely and then email the collection, as a pdf, back
out as well as make it available on the web.
<o:p></o:p></SPAN></FONT></P>
<P class=MsoNormal><FONT face=Arial size=2><SPAN
style="FONT-SIZE: 10pt; FONT-FAMILY: Arial"><o:p> </o:p></SPAN></FONT></P>
<P class=MsoNormal><FONT face=Arial size=2><SPAN
style="FONT-SIZE: 10pt; FONT-FAMILY: Arial">Cheers,<o:p></o:p></SPAN></FONT></P>
<P class=MsoNormal><FONT face=Arial size=2><SPAN
style="FONT-SIZE: 10pt; FONT-FAMILY: Arial">Martin
<o:p></o:p></SPAN></FONT></P></DIV></BLOCKQUOTE></BODY></HTML>