Merge pull request #5 from security-force-monitor/AddDownloadDocs

Add new page on downloads feature in WhoWasInCommand

build/gettext./datamodel.pot

@@ -0,0 +1,82 @@
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) 2022, Security Force Monitor
+# This file is distributed under the same license as the SFM Research Handbook package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: SFM Research Handbook \n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2022-05-06 16:39+0100\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"Language-Team: LANGUAGE <LL@li.org>\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#: ../../source/datamodel.rst:2
+#: 8a807a9f72414865bfda2a592d474b91
+msgid "What data does the Monitor collect?"
+msgstr ""
+
+#: ../../source/datamodel.rst:5
+#: e0145c1e23d34ad8bce2e5d3373e9a76
+msgid "Units, persons and incidents"
+msgstr ""
+
+#: ../../source/datamodel.rst:7
+#: 0078be78d321479887e0504cf2560366
+msgid "Security Force Monitor researches and creates data about three things (or \"entities\") related to security forces around the world:"
+msgstr ""
+
+#: ../../source/datamodel.rst:9
+#: 3253b2b4d259468985d2a79186566d57
+msgid ":ref:`Units` are official state or state-sanctioned organizations responsible for the internal or external security for a country, including the police, army, navy, air force and other security forces. Units refer to any any part of the hierarchy of a security force, ranging from a defense ministry with national jurisdiction, to a police unit based in a small town. Units can also be groupings of units such as \"operations\", \"joint task forces\" or peacekeeping missions. The Monitor collects data about a unit's name, aliases, bases and other physical infrastructure, geographical areas of operation and relationships with other units over time."
+msgstr ""
+
+#: ../../source/datamodel.rst:10
+#: 3654ae2f98ad4adf8c57ac7c96fe1209
+msgid ":ref:`Persons` are natural persons who are affiliated with, or hold positions of command over a specific unit at a particular point in time. The Monitor creates a dossier for each person, which includes their name, aliases, rank, title, role and the different units which they are affiliated with. In addition, we use a format called :ref:`Persons Extra` to capture data about a person's online and social media accounts, and media describing how a person looks and sounds"
+msgstr ""
+
+#: ../../source/datamodel.rst:11
+#: b1735fc1f784436d9454130d22798462
+msgid ":ref:`Incidents` are publicly-documented allegations of human rights violations committed by security forces. These include extrajudicial killings, rape, torture and other forms of violence. The Monitor does not make allegations itself, but rather complies allegations made by governmental bodies, human rights organizations and other civil society actors. For each incident, the Monitor includes a description from the source, date(s), specific location(s), its perpetrators and the types of human rights violation alleged to have happened."
+msgstr ""
+
+#: ../../source/datamodel.rst:13
+#: 1d4cac00614d44dab7451a2b63e1765b
+msgid "Every piece of data collected by the Monitor is individually sourced and each data point about :ref:`Persons` and :ref:`Units` is assigned a confidence score. The Research Handbook sections on :ref:`Sources` and :ref:`Data integrity measures` provide more guidance about these aspects of the data creation process."
+msgstr ""
+
+#: ../../source/datamodel.rst:15
+#: d06677da9ad542c6817d2e5ba20cb2f9
+msgid "Detailed guidance about the fields used by the Monitor to record data about :ref:`Units`, :ref:`Persons`, :ref:`Incidents` :ref:`Locations` is provided in the sections that follow."
+msgstr ""
+
+#: ../../source/datamodel.rst:18
+#: ac5d4689aa0d46809d0a98684c5926a9
+msgid "Sample data entry sheets"
+msgstr ""
+
+#: ../../source/datamodel.rst:20
+#: 05ded7a647ba4a149bfef0f4058910b2
+msgid "Security Force Monitor uses databases, spreadsheets and other tools to capture and analyse the data described in this Research Handbook. Though the spreadsheet can get quite large and unwieldy, it remains an extremely powerful and effective way to capture and store data. To assist you with your research, here are the formats we use as a Google Sheet, and in Excel and OpenDocument formats:"
+msgstr ""
+
+#: ../../source/datamodel.rst:22
+#: 1726b5f9c4604e339549eeae2990d69a
+msgid "Sample data entry sheets `in Excel format <_static/sfm_data_entry_20210416.xlsx>`_."
+msgstr ""
+
+#: ../../source/datamodel.rst:23
+#: fc551cbde6ef48abb7e1dc7386391339
+msgid "Sample data entry sheets `in Open Document format <_static/sfm_data_entry_20210416.ods>`_."
+msgstr ""
+
+#: ../../source/datamodel.rst:24
+#: a43432b548d5477fb36d705d9627f878
+msgid "Sample data entry sheets `as a Google Sheet <https://docs.google.com/spreadsheets/d/1-ae43_6JfXHZyC0-rYkOvnbB2RZgzyEy2VgJqAD_-KA/>`_."
+msgstr ""

build/gettext./downloads.pot

@@ -0,0 +1,274 @@
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) 2022, Security Force Monitor
+# This file is distributed under the same license as the SFM Research Handbook package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: SFM Research Handbook \n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2022-05-06 16:39+0100\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"Language-Team: LANGUAGE <LL@li.org>\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#: ../../source/downloads.rst:2
+#: 164cf5dac334424bb7a1c7063553bc5b
+msgid "What data can I download from WhoWasInCommand?"
+msgstr ""
+
+#: ../../source/downloads.rst:6
+#: d8d1e581225f46d595fe633c595150e9
+msgid "May 2022: The WhoWasInCommand.com download feature is experimental and subject to change. Currently, the downloads do not reflect improvements in how the Security Force Monitor data model deals with Locations."
+msgstr ""
+
+#: ../../source/downloads.rst:10
+#: 4a5772dd6e4f42e18cfe2c75324a96e3
+msgid "Data for download"
+msgstr ""
+
+#: ../../source/downloads.rst:12
+#: 6a17ec148e8c439d838d915891c95a81
+msgid "Any data published on WhoWasInCommand can be downloaded as a set of Comma Separated Values (.csv) files. These can be easily loaded into a spreadsheet or database tool for analysis. To use WhoWasInCommand's data download feature visit the following link:"
+msgstr ""
+
+#: ../../source/downloads.rst:14
+#: 470aff22abcb437fb5e35180d6d41d30
+msgid "https://whowasincommand.com/en/download"
+msgstr ""
+
+#: ../../source/downloads.rst:16
+#: d63f2039826040388790969d9f24eafd
+msgid "The Security Force Monitor data model is a directed graph containing attriutes about units, persons, locations as they change across time. This is quite complicated and does not easily translate into a single file that is straightforward to understand and use without guidance. To get around this and provide a way to provide raw data directly to users, we offer seven different reports drawn from the data on a specific country:"
+msgstr ""
+
+#: ../../source/downloads.rst:18
+#: d7fa5cd82c3448dba05663278a580205
+msgid "**Basic**: a list of all the units in that country"
+msgstr ""
+
+#: ../../source/downloads.rst:19
+#: b825d3243c2c42be8e66c5ed43ddb5f6
+msgid "**Parentage**: units organized into a hierarchy"
+msgstr ""
+
+#: ../../source/downloads.rst:20
+#: 7379fe99eef94b03b6d7a929ed2b85d4
+msgid "**Memberships**: units that are part of operations that may fall outside the regular chain of command"
+msgstr ""
+
+#: ../../source/downloads.rst:21
+#: 464bd27c238a4d3d97337b81ed94f058
+msgid "**Areas of operation**: geographical distribution of units' operational areas"
+msgstr ""
+
+#: ../../source/downloads.rst:22
+#: 24487317b19842848b800435111fb3c8
+msgid "**Sites**: specific locations"
+msgstr ""
+
+#: ../../source/downloads.rst:23
+#: 76923b469c844aa4bc9b918d01028b93
+msgid "**Personnel**: list of command personnel"
+msgstr ""
+
+#: ../../source/downloads.rst:24
+#: 0a58a66298224d32a0d005f2672985e3
+msgid "**Sources**: sources used to evidence the data"
+msgstr ""
+
+#: ../../source/downloads.rst:26
+#: 1bd91f614f8e476fbb96837604da84ad
+msgid "A full description of each downloadable slice of data is available in the sections below. It is important to note that none of the download contain the field-level sourcing that is a key part of Security Force Monitor's work (see :ref:`Data integrity measures` for more information). The reason for this is technical (discussed `here <https://github.com/security-force-monitor/sfm-cms/issues/661#issuecomment-635450705>`__ on the code repository for the software that powers WhoWasInCommand."
+msgstr ""
+
+#: ../../source/downloads.rst:29
+#: 459c6caff1ba4589ac21a82cb92ba81a
+msgid "How to download"
+msgstr ""
+
+#: ../../source/downloads.rst:31
+#: 0463b1bb63254678b79fbaf901f33750
+msgid "Visit the download page: `https://whowasincommand.com/en/download <https://whowasincommand.com/en/download/>`__"
+msgstr ""
+
+#: ../../source/downloads.rst:33
+#: a0daebf2919b40a7ab2da045bc755ff8
+msgid "The interface looks like this:"
+msgstr ""
+
+#: ../../source/downloads.rst:38
+#: cbeecbe87cf944e09e15f446878e55a1
+msgid "Use the dropdown menu to select the report that you want to download:"
+msgstr ""
+
+#: ../../source/downloads.rst:43
+#: 21c309fbd400456db2753295189bed0d
+msgid "Then, use the next dropdown menu to choose the country about which you want to download data:"
+msgstr ""
+
+#: ../../source/downloads.rst:48
+#: 6abb71f8930f4b52ab83b34148cdd3d9
+msgid "Optionally, tick the checkbox to include Confidence Scores in the downloaded report. Read the page on :ref:`Confidence scores` for more information about this data integrity measure. As mentioned above, downloads do not currently include field-level sourcing."
+msgstr ""
+
+#: ../../source/downloads.rst:50
+#: 87197ad722604b64b0708b3244266524
+msgid "Finally, click \"Download\" and a file containing the report will be downloaded to your computer. To help you identify the report, its filename is created using this simple template: ``[report_type]_-[country]_[YYYY-MM-DD].csv\"``"
+msgstr ""
+
+#: ../../source/downloads.rst:53
+#: 47f679a97f9b4cc5b49b16995b343d9a
+msgid "Contents of each download"
+msgstr ""
+
+#: ../../source/downloads.rst:55
+#: 14b1631e0e864086b3ab1acac428db09
+msgid "In this section we outline the seven different slices of data that users can download from WhoWasInCommand.com."
+msgstr ""
+
+#: ../../source/downloads.rst:58
+#: f8702af3a89b4b5a9d3a35e75df82a8a
+msgid "Download: Basic"
+msgstr ""
+
+#: ../../source/downloads.rst:60
+#: ../../source/downloads.rst:80
+#: ../../source/downloads.rst:107
+#: ../../source/downloads.rst:134
+#: ../../source/downloads.rst:162
+#: ../../source/downloads.rst:191
+#: ../../source/downloads.rst:237
+#: 631aa3db734b4c628fc7b98c48fd53f1
+#: 6e3d56858aba46c7bc00ebb5726034f7
+#: b5da3c27a5054db58347ecd99c841be3
+#: 13768321f42346e2a855442039bc4a2a
+#: 5275358b4ea84c7c9c40672d3e16f23c
+#: a3d55539e199411f8a6da517eb8e1577
+#: 70bca7ef44904d4088e48d7d19ee8dab
+msgid "**Description**"
+msgstr ""
+
+#: ../../source/downloads.rst:62
+#: 78bbdbf011cd4a98934587a626d5f079
+msgid "The \"Basic\" download contains a list of distinct units in the dataset, along with force branch, aliases, earliest and latest observation dates for each unit."
+msgstr ""
+
+#: ../../source/downloads.rst:64
+#: f3fce72eb65548f8b134a075fc966e43
+msgid "**Field**"
+msgstr ""
+
+#: ../../source/downloads.rst:66
+#: be54f47173454c9bbf7e2662c8af9c26
+msgid "1   unit:id:admin 2   unit:name 3   unit:country 4   unit:classification 5   unit:other_names 6   unit:first_cited_date 7   unit:last_cited_date 8   unit:first_cited_date_start 9   unit:last_cited_date_open ``"
+msgstr ""
+
+#: ../../source/downloads.rst:78
+#: a679db5b8bab43fbbd8a43e65794b5bd
+msgid "Download: Parentage"
+msgstr ""
+
+#: ../../source/downloads.rst:82
+#: a6a89b6ac9bf4966961770f697fbf17e
+msgid "The \"Parentage\" download contains data that describes how units fit into the organizational structure of the security and defence forces of the specified country. Each row contains a child-parent (``unit:name`` - ``unit:related_unit``) relationship inside the orgaizational hierarchy. Each row also contains data on the timescale for each relationship. You can find more information about how relatioships between units work in the :ref:`Unit: Related Unit` section of this handbook."
+msgstr ""
+
+#: ../../source/downloads.rst:84
+#: ../../source/downloads.rst:111
+#: ../../source/downloads.rst:138
+#: ../../source/downloads.rst:166
+#: ../../source/downloads.rst:195
+#: ../../source/downloads.rst:241
+#: 646005fa44114bac8d457eea7ec785d8
+#: ac76d75ca4a74e7b882fee9c1165ec79
+#: 3346cb2f11c64449a0779453995e1acc
+#: dd4f41260a80453dad2a085f7b25a2fb
+#: 6ea39114e2cb4f0f8ce31486c2cfea51
+#: 799c1768a9864ad487f14f24334f1f36
+msgid "**Fields**"
+msgstr ""
+
+#: ../../source/downloads.rst:86
+#: f78b474e55de49268d8cff6a109b8f08
+msgid "1   unit:id:admin 2   unit:name 3   unit:country 4   unit:classification 5   unit:other_names 6   unit:first_cited_date 7   unit:last_cited_date 8   unit:first_cited_date_start 9   unit:last_cited_date_open 10  unit:related_unit 11  unit:related_unit:name 12  unit:related_unit:country 13  unit:related_unit_class 14  unit:related_unit_first_cited_date 15  unit:related_unit_first_cited_date_start 16  unit:related_unit_last_cited_date 17  unit:related_unit_open"
+msgstr ""
+
+#: ../../source/downloads.rst:105
+#: 72d5025b66074c128422f2b34a011e8d
+msgid "Download: Memberships"
+msgstr ""
+
+#: ../../source/downloads.rst:109
+#: c1cc7c1bc2b74e209d1aaf238f7ec8e6
+msgid "The \"Memberships\" download contains data showing that the unit has been attached to internal/national joint operations, international peacekeeping operations, or other multi-unit efforts. These operational unit groupings exist in parallel to units' positionings in the regular organizational structure as described in the \"Parentage\" download. You can find more information about how memberships work in the :ref:`Unit: Related Unit` section of this handbook."
+msgstr ""
+
+#: ../../source/downloads.rst:113
+#: 44ac62bfc30b48a98eeef26fc59b88fb
+msgid "1   unit:id:admin 2   unit:name 3   unit:country 4   unit:classification 5   unit:other_names 6   unit:first_cited_date 7   unit:last_cited_date 8   unit:first_cited_date_start 9   unit:last_cited_date_open 10  unit:membership_id 11  unit:related_unit 12  unit:member_country 13  unit:member_classification 14  unit:related_unit_first_cited_date 15  unit:related_unit_first_cited_date_start 16  unit:related_unit_last_cited_date 17  unit:related_unit_open"
+msgstr ""
+
+#: ../../source/downloads.rst:132
+#: 90574ed8e68d48fb8b1ba440cb25ddc8
+msgid "Download: Areas of operation"
+msgstr ""
+
+#: ../../source/downloads.rst:136
+#: fd45aa423b1a41149f7f737bd4ac59e9
+msgid "The \"Areas of operation\" download describes the geographical areas that units have either been assigned to or in which they have been observed operating within. The Research Handbook sections :ref:`Unit: Location Type`, :ref:`Unit: Location` and :ref:`Locations` describe the concept of an area of operation in more detail."
+msgstr ""
+
+#: ../../source/downloads.rst:140
+#: f388adf29d994248949e86577f224397
+msgid "1   unit:id:admin 2   unit:name 3   unit:country 4   unit:classification 5   unit:other_names 6   unit:first_cited_date 7   unit:last_cited_date 8   unit:first_cited_date_start 9   unit:last_cited_date_open 10  unit:area_ops_id 11  unit:area_ops_name 12  unit:area_ops_country 13  unit:area_ops_feature_type 14  unit:area_ops_admin_level 15  unit:area_ops_admin_level_1_id 16  unit:area_ops_admin_level_1_name 17  unit:area_ops_admin_level_2_id 18  unit:area_ops_admin_level_2_name"
+msgstr ""
+
+#: ../../source/downloads.rst:160
+#: 9c144eade07a4487aa3f81871daed5d5
+msgid "Download: Sites"
+msgstr ""
+
+#: ../../source/downloads.rst:164
+#: caa75a2259974b1c8648eeb64a7f682b
+msgid "The \"Sites\" download describes the specific locations at which specific units have been observed. This download covers locations like infrastructure (such as police stations, barracks, airfields) and specific settlements. The Research Handbook sections :ref:`Unit: Location Type`, :ref:`Unit: Location` and :ref:`Locations` describe the concept of site in more detail."
+msgstr ""
+
+#: ../../source/downloads.rst:168
+#: fb0a17d5f4274eefa7de2b77de1272b9
+msgid "1   unit:id:admin 2   unit:name 3   unit:country 4   unit:classification 5   unit:other_names 6   unit:first_cited_date 7   unit:last_cited_date 8   unit:first_cited_date_start 9   unit:last_cited_date_open 10  unit:site_exact_location_id_latitude 11  unit:site_exact_location_name_longitude 12  unit:site_country 13  unit:site_feature_type 14  unit:site_admin_level 15  unit:site_nearest_settlement_id 16  unit:site_nearest_settlement_name 17  unit:site_first_admin_area_id 18  unit:site_first_admin_area_name"
+msgstr ""
+
+#: ../../source/downloads.rst:189
+#: 1a5e8b44726744e8b29296f2bb1d7910
+msgid "Download: Personnel"
+msgstr ""
+
+#: ../../source/downloads.rst:193
+#: 1c0f4369ce3047b0a943a5ada40600de
+msgid "The \"Personnel\" download provides data on people holding command positions in specific units. The download is organized by the unit to which a person was posted. It contains data on the person's posting (such as their role, rank, and title) in addition to any further biographical information (social media accounts, imagery of them, and so on). More information about how Security Force Monitor records data about persons is in the Research Handbook sections on :ref:`Persons` and :ref:`Persons Extra`."
+msgstr ""
+
+#: ../../source/downloads.rst:197
+#: 8caf796bc715424da5edae2921bb12a2
+msgid "1   unit:id:admin 2   unit:name 3   unit:country 4   unit:classification 5   unit:other_names 6   unit:first_cited_date 7   unit:last_cited_date 8   unit:first_cited_date_start 9   unit:last_cited_date_open 10  person:admin:id 11  person:name 12  person:other_names 13  person:country 14  person_extra:date_of_birth 15  person_extra:deceased_date 16  person_extra:deceased 17  person_extra:account_type 18  person_extra:account_id 19  person_extra:external_link_description 20  person_extra:media_desc 21  person_extra:notes:admin 22  person:posting_role 23  person:posting_rank 24  person:posting_title 25  person:posting_first_cited_date 26  person:posting_first_cited_date:year 27  person:posting_first_cited_date:month 28  person:posting_first_cited_date:day 29  person:posting_first_cited_date_start 30  person:posting_first_cited_date_start_context 31  person:posting_last_cited_date 32  person:posting_last_cited_date:year 33  person:posting_last_cited_date:month 34  person:posting_last_cited_date:day 35  person:posting_last_cited_date_end 36  person:posting_last_cited_date_end_context"
+msgstr ""
+
+#: ../../source/downloads.rst:235
+#: b8b32d452cd549d987abd1835b05a120
+msgid "Download: Sources"
+msgstr ""
+
+#: ../../source/downloads.rst:239
+#: 42431d0446024b33be0695f05ad37aa1
+msgid "The \"Sources\" download contains a list of all the sources used to evidence data on WhoWasInCommand. Unlike the other downloads, the content of the \"Sources\" download is not limited to a specific country: it's everything referenced anywhere in WhoWasInCommand. To learn more about how Security Force Monitor uses sources, visit the sections of the Research Handbook about :ref:`Data integrity measures` and :ref:`Sources`."
+msgstr ""
+
+#: ../../source/downloads.rst:243
+#: 90464b6ac8534ea7846565b1fa94a04a
+msgid "1   source:id:admin 2   source:title 3   source:type 4   source:author 5   source:publication_name 6   source:publication_country 7   source:published_timestamp 8   source:created_timestamp 9   source:uploaded_timestamp 10  source:url 11  source:access_point_id 12  source:access_point_type 13  source:access_point_trigger 14  source:accessed_timestamp 15  source:archive_url"
+msgstr ""