Help · Glossary

Glossary

What SynC's terms mean.

Documents and authoring

Terms

13

Coordination checklist
Every deferred requirement across a project's standards, in one list. An item is checked off by hand, or resolves on its own once a value is specified.
Datasheet
The fields of a standard that take a value: the equipment and material choices for one scope of work. In a project, a datasheet is the filled-in record of those values.
Datasheet for a scope of work
One standard can have several datasheets in a project, each for its own scope (indoor panelboards and outdoor panelboards, supply fans and exhaust fans). Each has its own values and its own history.
Deferred requirement
A field whose value is left to the drawings or to the project engineer instead of being fixed in the specification ("As indicated on the drawings"). Deferred requirements are listed, so a decision still owed is not read as complete.
Derived value
A datasheet field whose value follows from inputs already specified: a basic impulse level that follows from the system voltage and the site altitude, for example. The field names the basis, so whoever computes it arrives at the same answer. Different from a value deferred to the drawings, which another document carries.
Drawing reference
A mark on a datasheet field whose value is usually shown on the drawings rather than in the specification. It labels the field as deferred and puts the requirement on the project's coordination checklist.
Project parameter
A fact about the project (site altitude, seismic design category) answered once and used by every standard that refers to it, instead of being asked again in each datasheet. Where a standard refers to it, the answer is substituted. Unanswered, it shows as TBD.
Reconcile
Bring a datasheet to the revision of the standard its project now follows. Values that still fit carry forward. A removed option, a changed field or a value that no longer fits needs your decision before the change applies.
Requirement (clause)
One requirement in a specification, usually a single statement with "shall", "should" or "may". Each is a numbered clause (1.4.2, for example) so it can be cited exactly.
Section
A heading in a standard that groups related content (Scope, Products, Installation). Sections appear in the table of contents. They are not the numbered requirement clauses.
Specification
The written clauses of a standard. In a project, a specification is the project's copy of those clauses, tailored to the job with its own requirements and comments. It is also the construction-industry word for this kind of document.
Standard
The master for one subject: the specification clauses and the datasheet fields that go with them. A standard has its own revisions. Projects take their specifications and datasheets from it.
Standards markup
The syntax a standard is written in. It turns a plain text file into a configurable specification by marking which lines are sections, which are requirement clauses, and which datasheet fields take a value. The Standards markup syntax guide has the full reference.

Organization and libraries

Terms

7

Category
A grouping of standards within a discipline or a library, and the way specifications are filed within a project. Categories are how you browse to a standard.
Company
The organization people work for on SynC. Projects, libraries and seats belong to a company. Each person there is a Company admin, a Library manager or a Member.
Company library
A company's own standards, visible to the people at that company. It holds the standards the company keeps to itself or has tailored, alongside the open wiki.
Discipline
The top-level grouping of standards by trade or engineering field: Electrical, Mechanical, Instrumentation and Controls. Disciplines are the first level of the SynC Standards wiki.
Personal library
Your own standards, separate from the wiki and from any company library. A personal standard is drafted, revised and added to projects like any other.
Project
The specifications and datasheets for one job, built as a draft and published as revisions.
SynC Standards wiki
The open library of construction standards. Anyone can read it. Contributors write, moderators review, and a reviewer adopts the revision projects then use. Any project can take a standard from it.

Revisions

Terms

7

Adopted revision
The revision of a wiki standard that projects use. After contributors propose changes and a reviewer adopts them, that revision is the adopted one and the previous one is marked superseded.
Change type
The label on each field in a datasheet's history: added, revised or removed since the previous revision.
Content fingerprint
The short code you read and compare, taken from a revision's full content hash. If a single character of the content changes, the fingerprint changes, so a document can be checked against the revision it claims to be. The full hash is what verification uses.
Publish
Create a new revision of a project. Publishing seals the project's current state as the record you issue, cite and send.
Revision
A sealed snapshot of a project, standard or datasheet, with a content fingerprint. Once made, it does not change; a correction is the next revision.
Save revision
Turn a standard's working copy into a new numbered revision, such as 1.2.0. The revision is sealed; further edits start a new working copy.
Snapshot
The full content of a document as it stood when the revision was made, stored whole rather than as differences, so an older revision reads and verifies on its own.

Contribution and attribution

Terms

7

Adopter
The reviewer who adopts a wiki standard revision. Adoption is the editorial check that turns proposed changes into the revision projects use.
Attribution
The public record shown with a wiki contribution: the contributor's name, professional role and employer, as they stood when the contribution was made. It is a snapshot of that moment, not of today.
Conflict of interest disclosure
The full list of a contributor's active employers, shown on each contribution so readers can judge any bias for themselves. Every active employer is shown, in a neutral order, and a contributor cannot hide or reorder them. A contribution shown under a pseudonym leaves the employer names off but keeps the discipline and role.
Contributor
Anyone who has accepted the Contributor License Agreement and writes or edits standards in the SynC wiki. Contributions carry their name and become part of the open library.
Contributor License Agreement (CLA)
The agreement you accept before contributing to the SynC wiki. It gives SynC the rights it needs to host, change and distribute contributions while keeping the library open. When a new version is published, contributors accept it again.
Moderator
A person who reviews wiki contributions, manages categories and moderates content, to keep the library accurate and in order.
Trust badge
A mark beside certain contributions that says where they came from. The Official badge marks content SynC wrote itself (the SynC Standards Team, for example). Badges are given by SynC administrators, not earned automatically.

People and access

Terms

9

Company admin
Runs the company on SynC: members, roles, seats, billing and settings. Editing still requires a seat.
Employer association
A confirmed link between your account and a company. You can hold more than one at a time, as a consultant working for several companies does, and every active one is disclosed on your wiki contributions.
Join request
Your request to join a company on SynC, with a line saying what you do there. A company admin approves or declines it.
Library manager
Manages the company's libraries and categories, and issues errata. This work requires a seat.
Member
Belongs to a company on SynC. Reads and comments, and with a seat, edits.
Permission
One right to do one thing, such as edit a specification or export a project. Roles are made of permissions.
Primary employer
The employer you choose as your default when you have more than one. It sets the company for new work and for your profile headline. It does not change what is disclosed on contributions: every active employer is always shown.
Role
A set of permissions a person holds at a company or on a project. A role says what the person may do: create projects, edit specifications, manage members.
Seat
What lets a person edit at their company: create projects and edit standards, datasheets, libraries and categories. A company admin gives and removes seats. Without one, you can still read, comment and read drafts.

Sharing

Terms

5

Access record
The list on the Distribution page of every published revision sent to a recipient: who received which revision, when, and who sent it. A record is evidence of what was sent, not a right to open the project. You decide who has access and can remove it; removing access does not delete the record.
Distribution
Sending a published project revision to people outside the project. Each recipient gets a share link and signs in, or creates a free account, to accept it.
Forwarding
A recipient passing a share link on to someone else. You allow or refuse it when you create the link, and a forwarded acceptance goes on the access record like the first one.
Remove access
End access for a recipient who has already accepted a share link. Revoking a link is different: it stops anyone new accepting the link. Recipients keep any copies they exported before their access was removed.
Share link
A link that gives one recipient access to one published project revision, with what you allow: how long it lasts, who may use it, whether they may export, and whether they may forward it. Each acceptance goes on the access record.

Integrations and export

Terms

3

API key
A credential you create so a tool, agent or script of your own can use SynC on your behalf. Each key holds a subset of your own permissions, and you can revoke it at once.
Export
Saving a published project revision as a file outside SynC: a PDF package, Word, Markdown or JSON, where your role allows export. People who reached the project through a share link can export PDF and JSON, when the sender allows it.
Integration
A tool, agent or script connected to SynC through an API key. It works within the permissions you gave the key and never beyond your own access.