Skip to content

Commit 2558940

Browse files
committed
feat: Add Information architecture heuristics document
This commit adds an IA heuristics page to our process documentation. The NGINX DocOps teams spends a lot of time engaged with IA and is increasingly involved with using heuristics to assess content. This gives us a baseline of shared parameters and vocabulary for efforts going forward.
1 parent cad1d20 commit 2558940

File tree

2 files changed

+44
-0
lines changed

2 files changed

+44
-0
lines changed

documentation/README.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,4 +12,5 @@ If you're interested in contributing to the [NGINX documentation website](https:
1212

1313
## Topics
1414

15+
- [Information architecture heuristics](/documentation/ia-heuristics.md)
1516
- [Proposals](/documentation/proposals/README.md)

documentation/ia-heuristics.md

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
# Information architecture heuristics
2+
3+
This document describes some of the heuristics that the NGINX DocOps team uses to examine information architecture.
4+
5+
Is is intended as reference information for discussions and work management artefacts (Such as reports or issues).
6+
7+
These heuristics are an adaptation of work done by [Abby Covert](https://abbycovert.com/).
8+
9+
## Overview
10+
11+
| Name | Description |
12+
| ------------------------------- | ----------- |
13+
| [Accessible](#accessible) | |
14+
| [Clear](#clear) | |
15+
| [Communicative](#communicative) | |
16+
| [Controllable](#controllable) | |
17+
| [Credible](#credible) | |
18+
| [Delightful](#delightful) | |
19+
| [Findable](#findable) | |
20+
| [Learnable](#learnable) | |
21+
| [Useful](#useful) | |
22+
| [Valuable](#valuable) | |
23+
24+
## Accessible
25+
26+
## Clear
27+
28+
## Communicative
29+
30+
## Controllable
31+
32+
## Credible
33+
34+
## Delightful
35+
36+
## Findable
37+
38+
## Learnable
39+
40+
## Useful
41+
42+
## Valuable
43+

0 commit comments

Comments
 (0)