About Contribute Source | |
main/contribute/style |
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:
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.