Editing Module:Syrian Civil War detailed map/doc (section)

== Contested icon ==
===Definition===
The purpose of the contested icon ([[File:80x80-grey-black-anim.gif|11px]]) is to show two groups of soldiers fighting for control of a town, and that there is a significant number of troops ''inside'' the city actively holding territory. We generally turn a town contested based on ''widespread'' clashes reports. Contested means we cannot say one specific side controls the town. There should be evidence that the enemy is ''inside'' the town, which is a necessary (but not sufficient) condition for making a town contested. Contested status is appropriate if the town in question is controlled partly by one party, and partly by another. For example, it could be that one party controls the outer neighborhoods, while the other party holds the city center.

===Examples of cases where the contested icon should ''not'' be used===
* A case where there was no chance of the enemy taking the town over, and only small clashes were going on in the town. We don't mark towns contested if there are only sporadic clashes, so reports of clashes are not always enough to mark a town as contested.
* A case where there were clashes in a town with a handful of enemy fighters and the clashes were over after some hours. For example if a source says: "… at least six insurgents were killed during the clashes … while the rest of militants escaped on Saturday evening”
* A case where there was just one source about clashes in a major town and what occurred was essentially a small firefight. Sleeper cells infiltrated the town and shot at some soldiers, and the soldiers shot back and killed some of them. The source then reports the rest of the fighters as having fled the battlefield. So this was a one-off, hit-and-run attack, not a serious attempt to grab and ''hold'' parts of the town.
* A case where there were many separate reports of rebel ambushes on army checkpoints. This is not a ''seizure of territory'' inside of the town. The rebels do not control any part of the town, so a contested icon is unwarranted.
* A case where the enemy reached city limits. Well, they still haven't entered the city proper (which is the prerequisite for marking the city as "contested") When the city really becomes contested, a bunch of news outlets will be reporting on it. Just because there are enemies at the gates does not mean it is contested. The enemy needs to be making progress in the city. 
* The evidence should be especially strong to turn a “stronghold” contested. A few clashes, especially on the periphery are not enough. There should be evidence that the enemy can do more than just hit & run attacks. In these cases, a semi-circle is often enough.

===Cities===
[[File:Largecitycontested.png|thumb|250px|right]]The larger the size of the town, the more evidence is needed to make it contested. This is even more so the case for cities. Large cities (such as province capitals) are almost never marked as contested. Instead we make image mini-maps for them or put small icons on them to represent neighborhoods that are contested or controlled by a specific party. In contrast, a simple clash report of a small unknown village can turn it contested.

'''For example''', we would not mark as contested a city where a party still controls 95% of the city. Instead we mark specific enemy positions on the outskirts of the city until fighting in the city becomes widespread. As nobody claims there is any fighting inside of the city, it should be marked as colored dot within a siege circle (see Figure 1). Then, advanced points in the city should be marked as small dots in the color of the enemy (or small contested icons). In this specific case, a "contested" icon was added to represent the "west side of the city" that is contested (see Figure 2). This is more informative to our viewers. Since the code puts icons on the map in the order of code lines (starting with first line of code and ending with last line of code), the small "contested" icon should come in the line ''after'' that of the (large) city icon. Otherwise, the small icon will be hidden by the large icon and will therefore be invisible.

After the fights become more widespread in the city (& enemy controls a larger part of the city), we can remove the "west side of the city" icon and turn the whole city contested (see Figure 3). After this, if we learn that the enemy has taken over the whole city except for a small pocket (in south east) that is still resisting, then we change the contested icon into the color of the enemy and put a small dot representing the small pocket that is still resisting (see Figure 4).