---
# System prepended metadata

title: NoScript Docs Sprint

---

NoScript Docs Sprint
===
Aug 7, 2019, 14:00-18:00

Current state: https://noscript.net/faq

There's no manual of NoScript, though there are some user-generated content about NoScript 5... Turned into "Features". And then people started asking a lot of questions! Turned into "FAQ".

We should start from scratch! (Old site will be bundled.)

Goal 1: Support NS usage. Not a knowledge base, not a library of how the internet works and how scripts work.

Needed to explain both threat and mitigation at the same time! (This was new at the time!)
Strategy: Now just link to the Wikipedia.

Goal 2: include language around interoperability, "works best with"

### Use Cases
* Why should I use NS? -> features/value proposition
* What's the most effective way to use NS? Teaching people how to configure NS so they can optimise their set-up. "The path of least resistance." -> user guide/getting started
* New release! Something for existing users. (In addition to tooltips.) -> blog post or recommended set-up
* Directly be linked to a section from NS

![](https://i.imgur.com/zReP8t3.jpg)


### Vocabulary
documentation, getting started, manual, FAQ, features, guide, glossary


## Agenda

1. Taxonomy
2. IA
3. Table of Contents
4. Voice and Tone
5. Value Proposition
6. Goals for today


### Taxonomy

https://whimsical.com/44GAqoGif7Ly3W6EomNLFY

"script" does not apply to audio/video -- active content?

#### Glossary

**Owner**

**Site**

**Script**
- block, allow
Generic term for adjusting ...

**Content types**


**Saved rules**
- add, remove, edit
- search

**Site settings**
A set of owner permissions as applied to a specific site.

**Owner permissions**

**Options**
(general preferences)
- import/export/reset

**Preset**
- change

### Information Architecture

What is NS? Why should I use NS?
Getting started -> test this!
Documentation
Forum
About

Add-on store description

### Table of Contents

##### Existing content

- XSS pop-up
- no more high-contrast

##### To add

- scope
- per-site settings & automatically apply per-site settings
- tab settings propogation? TBD
- affiliated scripts
- HTTPS pop-up
- show fine-grained permissions (content types)
- tooltips


#### Getting started

Persona: new user (privacy advocate)
Give: screenshots, focus on core concepts, easy and safe, no more than 4 paragraphs

("How do I" for existing power users - with lots of examples)
Giorgio to set questions


#### Documentation

1. What NoScript does out of the box
2. Making a website work
3. Fine-tuning settings
4. Saved rules
5. Appearance
6. Configuration
7. Advanced options
    - XSS
    - HTTPS
    - (ClearClick and Clickjacking)
    - (ABE)
8. Import/export settings
9. Troubleshooting
10. Tips and tricks
11. Installing/uninstalling/updates

**(Appendix: Glossary)**
**(FAQ)**

### Voice and Tone

* authoritative but not comprehensive
* informative but not overwhelming 
* cautious but not paranoid
* accessible but not patronising 
* tongue-in-cheek but not sarcastic

### Value Proposition

NS buys you the time to make decisions about who you trust.
"first line of defense for your browser"
"it's not very smart, but it gives you time to decide who you trust"

NS allows you to make script blocking decisions easily.

NS gives you the most secure options by default.

NS displays how many scripts a website is loading.

NS usage = making a website work (rather than blocking scripts)

## To do's

* Name for this new version/release
* Default options
* 