Writing Style Guidelines

The goal of the Tensor Network is to be a resource for using tensor network methods in all fields of study. Therefore the majority of pages on the site should use domain-neutral language. This includes sticking to the same terminology conventions when describing tensors and avoiding using jargon or domain-specific terms. For example, the term “entanglement” should be avoided except in sections or on pages specifically discussing quantum physics.

Some other tips and guidelines for writing:

• Use a conversational style, preferring words which are understandable to readers with a general college undergraduate mathematics background.

• Provide a high level synopsis and concrete examples before giving formal specifications.

• Prefer to use tensor diagram notation whenever possible. A key exception is that when first introducing a topic, it is helpful to use traditional tensor notation to help readers more familiar with that notation.

• Keep formal or heavy mathematical notation (such as set notation) to a minimum except when:

  1. it is used to describe rigorous results, such as theorems
  2. it provides a useful clarification of subtle or formal concepts

• Keep the focus primarily on the subject matter. Avoid lengthy discussions of contributions of individuals or historical matters regarding academic literature, except on pages explicitly devoted to historical topics.

• Pages should not simply summarize academic papers. Instead, they should focus on a clearly defined, single topic. These topics may happen to correspond to one particular seminal paper, but the focus should remain on the topic itself.

Edit This Page