Merge pull request #10 from cogsec-collaborative/newreadme

Newreadme

ADMIN_HOWTO_decide_on_Tool_Needs.md

@@ -1,9 +1,25 @@
-# ADMIN_Howto decide on Tool Needs
+# Choosing Disinformation Deployment Tools
+
+## Disinformation deployments are not all the same
+
+CogSecCollab supports deployments of different sizes and types. Deployments we've run include:
+* single analyst working with open datasets, looking for patterns of behavior and extending knowledge about disinformation creators' assets.
+* Small team (4-6 people) collaborating on a short-term data task
+* Mid-sized team (20-50 people) collecting data and doing initial analysis on disinformation incidents lasting days
+* Large team (50+ people) going from collection to response
+
+Some of the factors in tool and process choice will include:
+* Team size: big teams need different resources to keep them organised
+* Tempo: longer, more academic investigations will need different toolings to real-time responses.
+* Environment: expected output forms/ formats will affect tool choice, as will any tool constraints created by being embedded in a larger team or system
+* Localisation: is this a single language or multiple? If there are maps being used, do the map tools include the areas of interest (e.g. non-US regions, disputed territories etc)
+
+## Example: larger deployment
 
 We will have n people distributed around the world, adding data to our system.  That data is:
 
-* Instances of disinformation.  Those instances are mostly going to be single examples of text, images, video or audio, with associated metadata, but could be groups of examples.  The meta will need to include the date & time that an instance appeared, where it appeared (twitter, facebook, etc), user, group, etc it appeared from/in, hashtags and other information added to the instance (e.g. image descriptions), and a URL to the original instance if possible. 
+* Instances of disinformation.  Those instances are mostly going to be single examples of text, images, video or audio, with associated metadata, but could be groups of examples.  The meta will need to include the date & time that an instance appeared, where it appeared (twitter, facebook, etc), user, group, etc it appeared from/in, hashtags and other information added to the instance (e.g. image descriptions), and a URL to the original instance if possible.
-* New disinformation narratives, e.g. “black people can’t catch Covid19”. 
+* New disinformation narratives, e.g. “black people can’t catch Covid19”.
 * New hashtags and other high-level information associated with disinformation incidents.
 
 We would like to take these instances into our system as raw data, and:
@@ -13,7 +29,7 @@ We would like to take these instances into our system as raw data, and:
 
 We will also have people in our communities who will add datasets to our system. That data is:
 * Results of searches for messages, images, video and audio associated with disinformation-related phrases, images, groups etc.  Much of this data will be in a format specific to the social media channel it was scraped from, which is often json or csv formatted.
-* Datasets provided by external disinformation researchers, relevant to Covid19; e.g. datasets released by social media platforms and other providers. 
+* Datasets provided by external disinformation researchers, relevant to Covid19; e.g. datasets released by social media platforms and other providers.
 
 We would like to take these datasets into our system as raw datasets, and:
 * Add them to our datastore

README.md

@@ -1,5 +1,30 @@
 # documentation
 Where we write stuff about writing stuff
 
-Advice notes and useful lists for people running and working on disinformation deployments. 
+Advice notes and useful lists for people running and working on disinformation deployments.
 
+## Managing a Disinformation Deployment
+
+* [Setting up a disinformation deployment](ADMIN_HOWTO_set_up_a_disinformation_deployment.md)
+* [Running a deployment with minimal tools: Slack and Googledocs](ADMIN_HOWTO_run_a_deployment_using_slack_channels.md)
+* [Deployment tools](ADMIN_HOWTO_decide_on_Tool_Needs.md)
+
+## Disinformation Resources
+
+* [Disinformation response glossary](LIST_Glossary_of_terms.md)
+* [Reading list](LIST_disinformation_reading.md)
+* [Disinformation teams](LIST_disinformation_teams.md)
+* [Disinformation tools](LIST_disinformation_tools.md)
+
+## Subject-specific resources
+
+Covid19 Specific Resources
+* [Covid19 disinformation teams](COVID19_Teams_collecting_and_processing_data.md)
+* [Covid19 disinformation data sources](COVID19_data_sources.md)
+* [Covid19 disinformation reading list](COVID19_disinformation_reading_list.md)
+* [Covid19 funding sources](COVID19_disinformation_funding_sources.md)
+
+## Technical Notes
+
+* [Save messenger audiofiles](TECH_HOWTO_save_messenger_audio_files.md)
+* []()