From f7f8a4bf054099c98722ad0b065f7916dd304e91 Mon Sep 17 00:00:00 2001
From: Lyudmila Vaseva <vaseva@mi.fu-berlin.de>
Date: Tue, 12 Mar 2019 09:55:39 +0100
Subject: [PATCH] Refine introducing new filter

---
 article/literature.bib  | 27 +++++++++++++++++++++++++++
 article/proceedings.tex | 12 ++++++------
 2 files changed, 33 insertions(+), 6 deletions(-)

diff --git a/article/literature.bib b/article/literature.bib
index c842534..b6c4129 100644
--- a/article/literature.bib
+++ b/article/literature.bib
@@ -56,6 +56,15 @@
                   \url{https://en.wikipedia.org/wiki/Wikipedia:Edit_filter}}
 }
 
+@misc{Wikipedia:EditFilterInstructions,
+  key =          "Wikipedia Instructions for Introducing a New Edit Filter",
+  author =       {},
+  title =        {},
+  year =         2019,
+  note =         {Retreived March 12, 2019 from
+                  \url{https://en.wikipedia.org/wiki/Wikipedia:Edit_filter/Instructions}}
+}
+
 @misc{Wikipedia:EditFilterManagement,
   key =          "Wikipedia Edit Filter Management",
   author =       {},
@@ -65,6 +74,24 @@
                   \url{https://en.wikipedia.org/wiki/Special:AbuseFilter}}
 }
 
+@misc{Wikipedia:EditFilterNoticeboard,
+  key =          "Wikipedia Edit Filter Noticeboard",
+  author =       {},
+  title =        {},
+  year =         2019,
+  note =         {Retreived March 12, 2019 from
+                  \url{https://en.wikipedia.org/wiki/Wikipedia:Edit_filter_noticeboard}}
+}
+
+@misc{Wikipedia:EditFilterRequested,
+  key =          "Wikipedia Requesting New Edit Filters",
+  author =       {},
+  title =        {},
+  year =         2019,
+  note =         {Retreived March 12, 2019 from
+                  \url{https://en.wikipedia.org/wiki/Wikipedia:Edit_filter/Requested}}
+}
+
 @Misc{CHINOSAUR:venue,
   author =       {@\_CHINOSAUR},
   key =          {_CHINOSAUR},
diff --git a/article/proceedings.tex b/article/proceedings.tex
index 773bace..0d6419e 100644
--- a/article/proceedings.tex
+++ b/article/proceedings.tex
@@ -546,7 +546,7 @@ The rules format can be viewed under \url{https://www.mediawiki.org/wiki/Extensi
 
 %TODO: Flowchart of the filtering process!
 
-Data generated by the extension in stored in following database tables: \emph{abuse\_filter}, \emph{abuse\_filter\_log}, \emph{abuse\_filter\_action} and \emph{abuse\_filter\_history}.
+Data generated by the extension in stored in following database tables: \emph{abuse\_filter}, \emph{abuse\_filter\_log}, \emph{abuse\_filter\_action} and \emph{abuse\_filter\_history}~\cite{gerrit-abusefilter}.
 
 \subsection{How is a new filter introduced?}
 //maybe move to governance?
@@ -554,16 +554,16 @@ Data generated by the extension in stored in following database tables: \emph{ab
 The best practice way for introducing a new filter is described under \url{https://en.wikipedia.org/wiki/Wikipedia:Edit_filter/Instructions}.
 According to the page, following steps should be implemented:
 \begin{itemize}
-    \item read the docs \url{https://www.mediawiki.org/wiki/Extension:AbuseFilter/Rules_format}
-    \item test with debugging tools  \url{https://en.wikipedia.org/wiki/Special:AbuseFilter/tools} (visible only for users who are already in the edit filter managers user group)
+    \item read the docs: \url{https://www.mediawiki.org/wiki/Extension:AbuseFilter/Rules_format}
+    \item test with debugging tools: \url{https://en.wikipedia.org/wiki/Special:AbuseFilter/tools} (visible only for users who are already in the edit filter managers user group)
     \item test with batch testing interface (dito)
     \item create logging only filter: \url{https://en.wikipedia.org/wiki/Special:AbuseFilter/new} (needs permissions)
-    \item Post a message at WP:EFN (edit filter notice board), so other edit filter managers have a chance to improve it
-    \item Finally, fully enable your filter, e.g. add warning, prevention, tagging, etc.
+    \item announce the filter at the edit filter notice board~\cite{Wikipedia:EditFilterNoticeboard}, so other edit filter managers can comment on it
+    \item finally, fully enable the filter by adding an appropriate edit filter action.
 \end{itemize}
 
 Performance/efficiency seem to be fairly important for the edit filter system;
-on multiple occasions, there are notes on recommended order of operations, so that the filter evaluates as resource sparing as possible.
+on multiple occasions, there are notes on recommended order of operations, so that the filter evaluates as resource sparing as possible~\cite{Wikipedia:EditFilterInstructions} or invitations to consider whether an edit filter is the most suitable mechanism for solving a particular issue at all~\cite{Wikipedia:EditFilter},~\cite{Wikipedia:EditFilterRequested}.
 
 \begin{comment}
 tips on controlling efficiency/order of operations
-- 
GitLab