Improving convention section
diff --git a/org.eclipse.rmf.documentation/rmf-latex/intro_conventions.tex b/org.eclipse.rmf.documentation/rmf-latex/intro_conventions.tex
index 29de310..d5dfc23 100644
--- a/org.eclipse.rmf.documentation/rmf-latex/intro_conventions.tex
+++ b/org.eclipse.rmf.documentation/rmf-latex/intro_conventions.tex
@@ -18,20 +18,22 @@
% Formatted like remark
\begin{info}
-This is where you'll find useful information or tips.
+Tips are marked with this icon. They usually summarize how to work more effectively. Details about the subject matter are found in the text.
\end{info}
\begin{warning}
-This will mark things to be aware of.
+Warnings are marked with this icon. They point out things that can go wrong, or important steps that are easily missed.
\end{warning}
\begin{example}
-Examples will be marked with a black square at the beginning and at the end of an example.
+Examples often demonstrate how a concept is applied in practice. They will be marked with a black square at the beginning and at the end, as shown with this text.
\end{example}
-When referring to \menu{menus} or \menu{user interface elements}, they are marked as shown here.
+When referring to \menu{menus} or \menu{user interface elements}, they are shown like here on gray background in small capitals.
-When we introduce a new \term{term} or want it to stand out, it will be marked like \term{this} in the text.
+When we introduce a new \term{term} or want it to stand out, it will be marked like \term{this} in the text. Often this is done only the first time that it appears.
+
+Terms that represent ReqIF model elements (e.g. SpecObject) are capitalized. Sometimes, we abbreviate them, for instance ``SpecElement'' instead of the full ``SpecElementWithAttributes''. They will still be capitalized to indicate that these are model elements.
\begin{definition}{Definition}
Definitions appear throughout the text and concisely define new terms. They appear in the text wherever they are introduced first. Please take advantage of the index at the end of the book to quickly find definitions.
