%% Presentation about Pygame

%% Some useful variations of the document class
%%\documentclass[ignorenonframetext,draft]{beamer}
%%\documentclass[ignorenonframetext,handout]{beamer}
\documentclass[ignorenonframetext,draft]{beamer}
\usepackage[T1]{fontenc}
\usepackage[utf8]{inputenc}
\usepackage{listings}
\mode<presentation>{\usetheme{Copenhagen}}
\title{Die neue Python-Dokumentation}
\author{Marek~Kubica}
\date{24.~Januar~2008}

%% get rid of navigation symbols
\beamertemplatenavigationsymbolsempty

\begin{document}

\frame{\titlepage}

\begin{frame}
  \frametitle{Der aktuelle Stand}
  \begin{itemize}
    \item Umfassende Dokumentation mit \LaTeX geschrieben
    \pause
    \item In vielen Formaten verfügbar (HTML, PDF, PostScript)
    \pause
    \item 1620 A4-Seiten PDF \pause (wobei \LaTeX mit Papier großzügig umgeht)
    \pause
    \item größtenteils von Guido van Rossum und Fred L. Drake, Jr geschrieben
    \pause
    \item \textit{Documentation matters} - einer der Gründe warum Python so
          populär ist.
  \end{itemize}
\end{frame}

\begin{frame}
  \frametitle{Besonderheiten}
  \begin{block}{Gegenüber Ruby}
    \begin{itemize}
      \item Umfassend (mit Tutorial, Referenz, Embedding-Anleitung, u.v.m.)
      \item \textit{Keine} generierte API-Dokumentation
      \pause
      \item Englisch ;)
    \end{itemize}
  \end{block}
  \begin{block}{Gegenüber Java}
    \begin{itemize}
      \item Mitgeliefert
      \item In verschiedenen Formaten verfügbar
      \item Einfacher mitzuarbeiten
    \end{itemize}
  \end{block}
\end{frame}

\begin{frame}
  \frametitle{API-Dokumentation}
  \begin{itemize}
    \item Es gibt auch javadoc-ähnliche Tools für Python
    \item pydoc, mitgeliefert
    \item Epydoc, kann mehr
      \pause (unter anderem reST)
    \item \url{http://epydoc.sourceforge.net/stdlib/}
  \end{itemize}
\end{frame}

\begin{frame}
  \frametitle{Kritik}
  \begin{block}{Am Format}
    \begin{itemize}
      \item \LaTeX umständlich zu schreiben - wenig Interessenten
      \item Umständlich zu generieren - von Fred L. Drake angepasstes LaTeX2HTML
      \item keine Suchfunktion (nur über Google-Bot und pyhelp.cgi)
      \item \url{http://starship.python.net/crew/theller/pyhelp.cgi}
      \item Look von 1995
    \end{itemize}
  \end{block}
  \begin{block}{Am Inhalt}
    \begin{itemize}
      \item zu wenige Beispiele
      \item keine Möglichkeit für User-Kommentare wie in PHP
        \pause (also nicht Web 2.0-kompatibel)
      \item Schlecht verknüpft, Dinge schwer aufzufinden
    \end{itemize}
  \end{block}
\end{frame}

\begin{frame}
  \frametitle{reST als Konkurrent zu \LaTeX}
  \begin{block}{Was ist das?}
    \begin{itemize}
      \item reStructured Text, ein Yet Another Markup-Format
      \item Konkurrenz zu Markdown, Textile und wie sie alle heißen
      \item Als Bestandteil der ``docutils'' entstanden
    \end{itemize}
  \end{block}
  \begin{block}{Code-Beispiel}
    Code here (highlighted by Pygments)
  \end{block}
\end{frame}

\begin{frame}
  \frametitle{Was bringt das nun?}
  \begin{itemize}
    \item Say something here
  \end{itemize}
\end{frame}

\end{document}
