Maybe a more lively tutorial can work.
Dynamic version:
Image may be NSFW.
Clik here to view.
Static version:
Image may be NSFW.
Clik here to view.
Image may be NSFW.
Clik here to view.
Image may be NSFW.
Clik here to view.
Image may be NSFW.
Clik here to view.
Code:
\documentclass{beamer}\usepackage{lmodern}\usepackage{graphics}\usepackage{ellipsis}\usepackage{csquotes}\usepackage{framed}\usepackage{tabularx}\usetheme{Madrid}\setbeamersize{text margin left=30pt,text margin right=30pt} \title{How to ask \emph{good} questions on \texse}\author[Prof.\ Paulinho van Duck]{Herr Professor Paulinho van Duck}\institute{Quack University}\newcommand{\texse}{\TeX.SE}\newcommand{\mwe}{MWE}\newcommand{\mweb}{MWEB}\newcommand{\op}{OP}\usepackage{tikzducks}\usetikzlibrary{positioning}\newbool{toleft}\global\booltrue{toleft}\newcommand{\duckfamily}[1][1]{% \begin{center} \begin{tikzpicture}[xscale=#1] \begin{scope}[scale=.15] \duck \end{scope} \begin{scope}[xshift=14pt, scale=.1] \duck \end{scope} \begin{scope}[xshift=14pt+10pt, scale=.1] \duck \end{scope} \begin{scope}[xshift=14pt+20pt, scale=.1] \duck \end{scope} \end{tikzpicture} \end{center}}\newcommand{\duckdecor}{% \ifbool{toleft}{% \duckfamily \global\boolfalse{toleft} }{% \duckfamily[-1] \global\booltrue{toleft} } }\usepackage[many]{tcolorbox}\tcbset{% enhanced, before skip=6pt plus 2pt minus 2pt, after skip=6pt plus 2pt minus 2pt, unbreakable, colframe=orange, colback=white, coltitle=black, fonttitle=\bfseries, boxed title style={colback=yellow!70!white}}\begin{document} \begin{frame} \titlepage\end{frame}\begin{frame}\frametitle{You are lucky, there's a ducky!}\begin{columns}[c] \begin{column}{.35\textwidth} \begin{tcolorbox}[adjusted title={Prof.\ van Duck}, attach boxed title to bottom, ] \centering \begin{tikzpicture} \begin{scope} \clip (0,0) -- ++(2.2,0) -- ++(0,2.6) -- ++(-2.2,0) -- cycle; \duck[body=yellow!50!brown!40!white, crazyhair=gray!50!white, eyebrow, glasses=brown!70!black, book=\scalebox{0.2}{\bfseries \texse}, bookcolour=red!20!brown] \end{scope} \end{tikzpicture} \end{tcolorbox} \end{column} \begin{column}{.57\textwidth} Hi, \TeX/\LaTeX\ friends! \smallskip I am \mbox{Herr Professor Paulinho van Duck}. \smallskip I would like to help newbies to ask \emph{good} questions on \texse. \smallskip That's the correct way to have rapid and smart answers, quack! \end{column}\end{columns}\end{frame}\begin{frame}\frametitle{How you should \emph{not} ask: \emph{just-do-it-for-me} questions}\emph{Just-do-it-for-me} questions do not show any effort by the \op\ (the Original Poster in the \texse\ jargon).\begin{columns}[c]\hspace{.02\textwidth}\begin{column}{.47\textwidth} \begin{framed} \centering \textbf{How can I do this in \LaTeX?} \begin{tikzpicture}[scale=.7] \begin{scope}[xscale=-1] \duck[longhair=brown, water=cyan!50!blue] \end{scope} \begin{scope}[xshift=12pt] \duck[crazyhair=orange, water=cyan!50!blue] \end{scope} \end{tikzpicture} \end{framed}\end{column}\begin{column}{.47\textwidth} \vspace{10pt} Posts like the one on the left have many flaws: \begin{itemize} \item generic title \item no explanation of what the problem is \item no example of code. \end{itemize}\end{column}%\end{columns}\bigskipPlease \emph{never} ask such stuff. A little duck cries when he sees them, quack!\end{frame}\begin{frame}\frametitle{How you should \emph{not} ask: \emph{crystal ball} questions}Questions like the one below give not enoughinformation to be answered.\begin{columns}[c]\hspace{.02\textwidth}\begin{column}{.47\textwidth}\begin{framed} \noindent\textbf{Why doesn't my code work?} \vspace{\belowdisplayskip}\noindent My code worked till yesterday, but now it gives me an error. Why?\end{framed}\end{column}\begin{column}{.47\textwidth}\vspace{10pt}Do you think we have a \mbox{crystal ball}? \smallskipOr that we can read \mbox{your mind}?\smallskipWhich is the error? \smallskipWhere is an example of your code?\end{column}%\end{columns}\bigskipPlease \emph{never} ask such stuff. A little duck despairs when he sees them, quack!\end{frame}\begin{frame}\frametitle{The asking-a-good-question guidelines}On the contrary, if you are a smart user, you will follow these guidelines:\bigskip\begin{tcolorbox}[adjusted title={Van Duck's rules},attach boxed title to top]\begin{enumerate}\item Read the package manuals\item Look at the log generated by the code\item Search on \texse\ and, in general, on the Internet\item Add a minimal working example (\mwe) to your question\end{enumerate}\end{tcolorbox}\end{frame}\begin{frame}\frametitle{What you should do \emph{before} asking: read the \emph{manuals}}One of the biggest benefits of \TeX/\LaTeX\ is its rich documentation.\medskipReading the package manuals could be boring, sometimes even impossible (the Ti\emph{k}Z \& PGF one has more than 1,000 pages, quack!)but information such as the incompatibilities or the loading order is usually written at the beginning. \medskip At least a rapid look at the documentation is mandatory, quack!\end{frame}\begin{frame}\frametitle{What you should do \emph{before} asking: look at the \emph{log}}The log is your friend in the case of errors.\medskipOK, \TeX\ error descriptions are not the ultimate in clarity, quack!But if you search them on the Internet, you'll find the solution or, at least, you'll understand what they mean.\medskipThe most important error is the first one, the others may be a consequence of that one.\duckdecorThe command \texttt{\string\listfiles} writes on your log the versions of all the packages you are using (it also works when there are no errors).\medskipMany problems could be solved merely updating your \TeX\ distribution, quack!\end{frame}\begin{frame}\frametitle{What you should do \emph{before} asking: \emph{searching}}If you have a problem, it is very likely that someone else had thesame before: search on the Internet, quack!\medskipPay attention: like everything you find on the web, some information could be incorrect or obsolete.\medskipHere a list of the reliable resources:\url{https://tex.stackexchange.com/q/162/101651}.\duckdecorYou could also directly use the search field on the top right of\texse\ main site home page.\medskipFor more info: \url{https://tex.stackexchange.com/help/searching}. \end{frame}\begin{frame}\frametitle{How you \emph{should} ask}If all your searching was fruitless, let's see how to ask a question:\begin{enumerate}\item the title: be specific! Do not write things like\emph{How can I do this in \LaTeX?} or \emph{Why doesn't my code work?}\item the body: give all the details to understand your problem and add your \mwe\\item the tags: add the correct tags!Look at the tag description before using it. \end{enumerate}\medskipFor more info:\url{https://tex.stackexchange.com/help/how-to-ask}.\end{frame}\begin{frame}\frametitle{The essential: the \emph{minimal working example (\mwe)}}How to write an \mwe:\begin{enumerate}\item the \texttt{\string\documentclass}: always indicate it. Many things can change if you are using \texttt{beamer} instead of \texttt{article}, for example.\item the packages: list all the packages needed to reproduce your problem,and only those, do not be verbose, quack!\item the \texttt{document} environment: put your code within \texttt{\string\begin\string{document\string}} and \texttt{\string\end\string{document\string}} and add only the lines strictly necessary to reproduce your problem. Do not post only code snippets.\end{enumerate}Test your \mwe\ before adding it to your question.You have to be sure it works or, if it does not work, it gives the same error you are struggling about.\end{frame}\begin{frame}\frametitle{Packages and pages useful for \mwe\ writing}Many packages help you to create an \mwe. \medskip \texttt{lipsum} and \texttt{blindtext} produce some text with no meaning, just to fill your pages preserving your privacy or copyright. \texttt{graphicx} allows you to use some example images. There is also an \texttt{mwe} package, guess what it is for, quack!\texttt{showframe} could be handy in case of\emph{Overfull hbox} or, in general, for refining the alignment.\duckdecorFor more info about \mwe: \url{https://tex.meta.stackexchange.com/q/228}and about \mwe\ with bibliography (\mweb):\url{https://tex.meta.stackexchange.com/q/4407}. \end{frame}\begin{frame}\frametitle{What you should do \emph{after} asking}Once you have posted your question, your work is not over.\medskipPay attention to the possible comments of other usersand reply to them. Usually, they ask for clarifications.\duckdecorWhen someone posts the answer withthe solution you were waiting for,accept it by clicking the specific tick.\duckdecorIf you have more than 15 reputation points, you can also upvote all the answers which are useful for you, please do it, quack!\end{frame}\begin{frame}\frametitle{The correct way to say \emph{thank you!}}Users who answered arenot paid for it, accepting and upvoting are the correct ways to say \emph{thank you!}\medskip\begin{tcolorbox}[adjusted title={How to thank},attach boxed title to top]\vspace{-4pt}\centering\begin{tikzpicture}[%tondo/.style={circle, draw=orange, thick, text width=1.5em},quadro/.style={%rounded corners, draw=orange, thick, align=center,font={\small},text width=12em,minimum height=9ex},freccia/.style={orange, thick, -stealth}]\node[inner sep=0pt] (foto) {\includegraphics[width=.11\textwidth]{tick}};\node[tondo, above right=-26pt and -24.5pt of foto] (upv) {};\node[tondo, below right=-20pt and -24.5pt of foto] (acc) {};\node[quadro, right=10em of upv.north, anchor=north] (dupv) {Click here to \emph{upvote} \\ any useful post};\node[quadro, right=10em of acc.south, anchor=south] (dacc){Click here to \emph{accept} \\ the best answer to your question};\draw[freccia] (dacc.west) -- (acc);\draw[freccia] (dupv.west) -- (upv);\end{tikzpicture}\end{tcolorbox}\end{frame}\end{document}P.S. = if someone can manage to share the pdf in a better way, I'll be grateful!
