Stack Exchange Network

Stack Exchange network consists of 175 Q&A communities including Stack Overflow, the largest, most trusted online community for developers to learn, share their knowledge, and build their careers.

Visit Stack Exchange

Questions tagged [information-architecture]

This tag should be used for questions that are related to writing in a technical environment with a focus on architecture, such as when asking about how you could document a complex hierarchical system or creating a userguide for a bigger system.

5
votes
2answers
73 views

For HTML documentation sets, are there meaningful guidelines for topic length?

We produce a large HTML documentation set with the conventional two-pane view: expandable table of contents on the left, selected topic on the right. When you select a topic, if it has subtopics -- ...
3
votes
1answer
63 views

How do I mix linear and non-linear “choices” in an interactive novel?

In my interactive novel, I'm trying to keep the word count between choice prompts fairly short and consistent, but that means sometimes breaking up longer text into a few sections…. I've been using ...
11
votes
3answers
483 views

How to effectively document a product composed of complex microservices?

I have a highly flexible software product consisting of a series of loosely coupled microservices. Each component is effective at a single job, but may be dependent on inputs from other services. It ...
9
votes
2answers
2k views

How should I document a database schema?

I am going to be writing some user-facing documentation for a database that visitors can query. That is, the people writing queries are not the ones who created the database; they can come in, look ...