Publishing
The review checklist, publishing with contributor access or submitting for review, and how the model file is built and attached.
Before you publish
Open Review. Its checklist shows what is done and what is missing:
- the device or part has its own name;
- the maker is named;
- for a device, the port openings placed; for a part, how it mounts and its decks;
- how many values are measured, from the datasheet, or estimated;
- every problem with the measurements.
Warnings and notes don't stop you, but errors do: the button says Fix the N problem(s) above first until they are gone. Values left unmarked count as estimated, and a device with no real measurements helps nobody.
You need to be signed in. The first time you publish anything, Rack Maker asks you to agree to share your catalog contributions under CC BY-SA 4.0. See Licences and credits.
Publish or submit for review
What the button does depends on your access. See Contributing.
With contributor access: Publish
Publish does it all in one go:
- builds the model file (GLB) in your browser from your measurements;
- uploads it with its credits: made by you, under CC BY-SA 4.0 like the entry;
- submits the revision and approves it.
In your own namespace the device is published at once, and you are taken to its page. In someone else's namespace it waits for that namespace's maintainers.
Without contributor access: Submit for review
Submit for review sends your measurements to an admin, without a model file (uploading files needs contributor access). Until it is approved, the device is a draft that only you see. In your projects it is drawn from its measurements, built in your browser: the same model the file would hold.
When an admin approves it, their browser builds the model file and attaches it to the revision there and then. Ask for contributor access on the Catalog page.
What is published
- The measurements, in the revision: size, shape, mounting, ports, zones, finishes, weight, and where each number came from. Anyone can reopen them with Edit measurements on the entry's page and publish a correction as a new revision (or a copy in their own namespace that credits you). See Entries and revisions.
- The model file, with its credits.
- The datasheet link from the Name step. Kept datasheet PDFs stay private.
- Never your photos. No photo or logo goes on the model; the finishes are generated textures.
A published revision never changes. Editing it again in the modeler starts the next revision.
The model file
The model file is always built from the measurements, by the same builder, wherever that runs:
- In your browser, when you choose Publish.
- On the server, when your agent publishes with contributor access. The entry has its model file straight away, whether or not a browser is open. See Using AI agents.
- Later, in a browser, if the server couldn't build it (a build error, or a model over 30,000 triangles). The revision is published with its measurements and drawn from them everywhere. The next time you, as its author, or an admin open it in the modeler or see it in a project, the browser builds the file and attaches it, with a short notice. If that fails, it is tried again the next time.
Each port becomes a named point in the model file, and is also listed in the entry's data, so projects know where every port is.
If the draft is open elsewhere
If your agent, or another of your browsers, publishes or submits the draft while you have it open, the modeler tells you: "This draft was published. What you change next goes into a new revision." It stops saving to the published revision, and your next change starts a new one. Nothing is lost. See Live sync.
Photos and port detection
Add several photos of a device, find its ports, vents and LEDs on them in your browser, review the candidates, and let your agent use them with your words and annotations.
Live sync
Your signed-in browsers and your AI agent see the same modeler draft as it changes, and how conflicting changes are settled.