---
title: "Introducing Project Swordfish [Organizing Content 2]"
date: 2010-05-17
description: "Findability / organizing content 1.0 New Series: Organizing Content [Organizing Content 1] 1.2 → Introducing Project..."
canonical_url: https://idratherbewriting.com/2010/05/17/introducing-project-swordfish-organizing-content-2/index.html
---

> For AI agents: a documentation index is available at https://idratherbewriting.com/llms.txt. Markdown versions of all pages are available by appending .md to any page URL.

# Introducing Project Swordfish [Organizing Content 2]

1. [1.0 New Series: Organizing Content [Organizing Content 1]](https://idratherbewriting.com/2010/05/17/new-series-organizing-content-organizing-content-1/)
2. 1.2 → Introducing Project Swordfish [Organizing Content 2]
3. [1.3 Things Fall Apart, The Centre Cannot Hold [Organizing Content 3]](https://idratherbewriting.com/2010/05/17/things-fall-apart-the-centre-cannot-hold-organizing-content-3/)
4. [1.4 Imposing Order Versus Observing Order [Organizing Content 4]](https://idratherbewriting.com/2010/05/18/imposing-order-versus-observing-order-organizing-content-4/)
5. [1.5 Topic-Based, Hierarchical Navigation [Organizing Content 5]](https://idratherbewriting.com/2010/05/19/topic-based-hierarchical-navigation-organizing-content-5/)
6. [1.55 25 Facets for Navigation [Organizing Content 5]](https://idratherbewriting.com/2010/05/17/25-facets-for-navigation-organizing-content-5/)
7. [1.6 Faceted Classification, Faceted Search [Organizing Content 6]](https://idratherbewriting.com/2010/05/20/faceted-classification-faceted-search-organizing-content-6/)
8. [1.7 Implementing Faceted Classification/Search with a Help Authoring Tool [Organizing Content 7]](https://idratherbewriting.com/2010/05/21/implementing-faceted-classificationsearch-with-a-help-authoring-tool-organizing-content-7/)
9. [1.8 Second-Level Faceted Navigation [Organizing Content 8]](https://idratherbewriting.com/2010/05/25/second-level-faceted-navigation-organizing-content-8/)
10. [1.9 Browse Versus Search: Stumbling into the Unknown Unknown [Organizing Content 9]](https://idratherbewriting.com/2010/05/26/browse-versus-search-organizing-content-9/)
11. [2.0 Figuring Out Search Algorithms [Organizing Content 10]](https://idratherbewriting.com/2010/05/27/figuring-out-search-algorithms-organizing-content-10/)
12. [2.1 Search Engine Optimizing Your Help Content for Google [Organizing Content 11]](https://idratherbewriting.com/2010/05/28/search-engine-optimizing-your-help-content-for-google-organizing-content-10/)
13. [2.2 From Help Authoring Tools to Web Tools, Especially Wikis [Organizing Content 12]](https://idratherbewriting.com/2010/06/03/from-help-authoring-tools-to-web-tools-especially-wikis-organizing-content-12/)
14. [2.3 Using Mediawiki Templates to Organize Content [Organizing Content 13]](https://idratherbewriting.com/2010/06/09/using-mediawiki-templates-to-organize-content-organizing-content-13/)
15. [2.4 The Semantic Web and Content Findability: Interview with Patrick Warren [Organizing Content 14]](https://idratherbewriting.com/2010/06/10/the-semantic-web-and-content-findability-interview-with-patrick-warrant-organizing-content-14/)
16. [2.5 Faulty Assumptions About the Scope of Help Content? [Organizing Content 15]](https://idratherbewriting.com/2010/06/11/faulty-assumptions-about-the-scope-of-help-content-organizing-content-1/)
17. [2.6 Can Blogs Work as a Web Platform for Help? [Organizing Content 16]](https://idratherbewriting.com/2010/06/23/can-blogs-work-as-a-web-platform-for-help-organizing-content-16/)
18. [2.7 Organizing Content as Story [Organizing Content #17]](https://idratherbewriting.com/2010/06/29/organizing-content-as-story-organizing-content-17/)
19. [2.8 Separating Basic from Advanced Topics: How Twitter Organizes Their Help [Organizing Content #18]](https://idratherbewriting.com/2010/07/08/separating-basic-from-advanced-topics-how-twitter-organizes-their-help-organizing-content-18/)
20. [2.9 Emergence [Organizing Content #19]](https://idratherbewriting.com/2010/07/20/emergence-organizing-content-19/)
21. [3.0 Relying on the Wisdom of the Crowds with Help Authoring [Organizing Content #20]](https://idratherbewriting.com/2010/07/27/relying-on-the-wisdom-of-the-crowds-with-help-authoring-organizing-content-20/)
22. [3.1 Principles for Organizing Print Material [Organizing Content #21]](https://idratherbewriting.com/2010/07/30/principles-for-organizing-print-material-organizing-content-21/)
23. [3.2 The Technical Writer as an Outsider: How Ambitious Are You? [Organizing Content #22]](https://idratherbewriting.com/2010/08/06/the-technical-writer-as-an-outsider-how-ambitious-are-you/)
24. [3.3 The Interface Is Text [Organizing Content #23]](https://idratherbewriting.com/2010/08/11/the-interface-is-text-organizing-content-23/)
25. [3.4 Best Practices for Writing Interface Text [Organizing Content #24]](https://idratherbewriting.com/2010/08/13/best-practices-for-writing-interface-text-organizing-content-24/)
26. [3.5 Organizing for Learnability [Organizing Content #25]](https://idratherbewriting.com/2010/09/01/organizing-for-learnability-organizing-content-25/)
27. [3.6 Why Learning Software Is So Hard, and Organizing Content into Levels [Organizing Content #26]](https://idratherbewriting.com/2010/09/09/why-learning-software-is-so-hard-and-organizing-content-into-levels-organizing-content-26/)
28. [3.7 Is Rhetoric Relevant? Considering the "Message in Context" [Organizing Content #27]](https://idratherbewriting.com/2010/09/22/whence-rhetoric/)
29. [3.8 Organizing Content for Constructivist Learning [Organizing Content #28]](https://idratherbewriting.com/2010/09/27/organizing-content-for-constructivist-learning-organizing-content-28/)
30. [3.9 Eight Defining Questions that Shape Content Organization [Organizing Content #29]](https://idratherbewriting.com/2010/10/01/eight-defining-questions-that-shape-content-organization-organizing-content-29/)
31. [4.0 Why Help Content Fails and #contentstrategy](https://idratherbewriting.com/2010/10/22/why-help-content-fails-contentstrategy/)

Welcome to the new project you'll be documenting: Project Swordfish. Project Swordfish is an application used by the FBI to train agents in virtual simulations of undercover operations.

With Swordfish, users can be super agents and regular agents. The super agents can configure the permissions of the regular agents with 20 different permission settings. This means the relevant help topics for any agent can vary from about 10 topics to all 200 topics, depending on the permissions an agent has.

An agent with all 20 permissions will find that every topic in the help is relevant. An agent with no permissions will find that just a handful of topics in the help are relevant.

Some of the permission settings for the agents include the following:

- Allow agent to view master operations list
- Allow agent to create new operations
- Allow agent to close operations
- Allow agent to create operation maps
- Allow agent to add or remove members from his team

You get the idea. (By the way, this isn't real.)

In Swordfish, agents are grouped into teams. The same agent can be on multiple teams, with different permissions on each team. For example, an agent can be a super agent on the Black Operations team, but a regular agent on the Public Operations team. Agents can even be double agents, so that they appear to be regular agents on a team but are actually super agents, and vice versa.

Project Swordfish has a moderately complicated interface that warrants approximately 200 help topics. Help topics include several types of topics: conceptual topics, task topics, videos, context-sensitive help topics, and FAQ topics. You need to create both an online help file as well as several printed guides. *Your main task is to organize the help topics in a way that makes sense to users.*

Content organization is the focus of this series, so that's what the upcoming posts will explore -- different ways to organize content from this hypothetical documentation scenario.