OpenNewsLabs / field-guide-security-training-newsroom

A resource for anyone helping journalists and newsrooms step up their security practices.
https://securitytraining.opennews.org
MIT License
40 stars 11 forks source link

The Field Guide to Security Training in the Newsroom v 1.0.0

The Field Guide to Security Training in the Newsroom is a round up of resources and lesson plans designed to improve and expand newsroom digital privacy training.

This curriculum is hosted by OpenNews, a team that helps developers, designers, and data analysts convene and collaborate on open journalism projects. The first draft was composed during a two-day convening in Chicago in June 2017. The curriculum launched publicly in the Spring of 2018.

This is a living resource and we welcome your contributions and feedback.

Our goal is not to replicate good work that other organizations have already done, so if you know about great training resources for security trainers, we'd love to add those to our resource roundup.

More ways to contribute

Building the Guide

The field guide is published on ReadTheDocs using Sphinx, a Python-based documentation system. If you have changes to share and want to preview them before sending us a pull request, here's how to build the guide locally. (Note that these instructions assume a Unix-like environment. If you're using OS X or Linux, you should be good to go. Windows 10 users should consider enabling the Windows Subsystem for Linux - users of earlier Windows versions should look into Cygwin.)

  1. If they're not already available, install Python 2, pip, and virtualenv. For more information, see the Python Beginners Guide.
  2. From the command line, create and activate a new virtualenv:
    virtualenv field-guide
    cd field-guide
    source bin/activate
  3. Fork the project on Github and clone your fork on your local computer, within the virtualenv directory:
    git clone <your fork here> 
    cd field-guide-security-training-newsroom
  4. From the command line, use pip to install the necessary modules:
    pip install -r requirements.txt 
  5. From the the project's docs subdirectory, run the command make html. This will build the guide in the docs/_build/html project subdirectory.

(The make utility is installed by default on most unix-like environments. If you see errors like make: command not found, you should install the base development tools for your environment, which will include make.)

  1. Open the file docs/_build/html/index.html in your browser to view the local copy of the guide.

  2. Run make html again after any changes to update your local copy.