+- LDraw.org Discussion Forums (https://forums.ldraw.org)
+-- Forum: General (https://forums.ldraw.org/forum-12.html)
+--- Forum: Parts Tracker Discussion (https://forums.ldraw.org/forum-36.html)
+--- Thread: LDraw.org Official Parts Library Standards: Introduction (/thread-29491.html)
LDraw.org Official Parts Library Standards: Introduction - Orion Pobursky - 2026-04-22
It's time to start discussing the LDraw.org Official Parts Library Standards.
I'll kick this off with 2 items:
1. Is the title "LDraw.org Official Parts Library Standards" a good title? Should we use something better?
2. Review the "Introduction" section and provide feedback.
https://library.ldraw.org/documentation/ldraworg-official-parts-library-standards/introduction
Desired feedback includes, but is not limited to:
- Content
- Grammar
- Page format
- Page styling (i.e. the overall look and feel)
- Page navigation
RE: LDraw.org Official Parts Library Standards: Introduction - N. W. Perry - 2026-04-22
(2026-04-22, 20:27)Orion Pobursky Wrote: 1. Is the title "LDraw.org Official Parts Library Standards" a good title? Should we use something better?
It's good, assuming this is to replace the many current sub-topics: library header, library part number, library sticker parts…
Bringing all of these together under a unifying title would be a Good Idea™.
It would also be Good to differentiate the library regulations from the file format, by use of the words "standard" vs. "specification" (or some other). Right now we have library "standards" that contain various "specifications". Meanwhile we have the file format "specification" (though that is governed by the "standards" board). I still get all the different documentation confused with respect to these names.
Quote:2. Review the "Introduction" section and provide feedback.
I'll have more later, but just quickly I notice that the right-hand navigation sidebar on the intro section is mis-sized (requires scrolling just to fit the word "introduction"). Other pages seem to be correct.
RE: LDraw.org Official Parts Library Standards: Introduction - Rene Rechthaler - 2026-04-22
The "auto-correct" should be done (and displayed) before the final upload
things which could be in auto-correct (maybe they are already there):
-tilde in subparts
-correct parttype prefix (subpart/prim on both part name and parttype)
-correct license
RE: LDraw.org Official Parts Library Standards: Introduction - Orion Pobursky - 2026-04-22
(2026-04-22, 22:43)Rene Rechthaler Wrote: The "auto-correct" should be done (and displayed) before the final upload
things which could be in auto-correct (maybe they are already there):
-tilde in subparts
-correct parttype prefix (subpart/prim on both part name and parttype)
-correct license
Good feedback. Despite my bringing it up, I think what the PT does or doesn't auto correct should probably be spun off into its own thread once we're done with section review
RE: LDraw.org Official Parts Library Standards: Introduction - N. W. Perry - 2026-04-23
Good idea on setting off requirements in a text box; we may find there are other types of content to highlight in other kinds of boxes (deprecated practices, optional provisions, etc.).
I think there's a way to make the "Please note" section a little more clear. Something like:
"These standards have evolved over time, and there may be official parts in the LDraw.org Parts Library that do not conform to these requirements. Such parts need not be edited and re-submitted solely for the purpose of bringing them into compliance. However, all parts submitted to the Parts Tracker, whether new parts or fixes to existing official parts, must conform to the current library requirements."
RE: LDraw.org Official Parts Library Standards: Introduction - Chris Böhnke - 2026-04-23
Looking good so far.
Missing a word?
"Text not in a block quote box is intended [to] explain or otherwise provide context to the requirement."
I really like the textboxes.
Quote:N. W. Perry:
"[...] we may find there are other types of content to highlight in other kinds of boxes [...]"
So different colored boxes or should there be a small symbol next to them? I somehow like the idea, but I'm also afraid it might cause a bit of an overload.
RE: LDraw.org Official Parts Library Standards: Introduction - N. W. Perry - 2026-04-23
(2026-04-23, 6:02)Chris Böhnke Wrote: So different colored boxes or should there be a small symbol next to them? I somehow like the idea, but I'm also afraid it might cause a bit of an overload.
Probably different colored. Indeed, they should be used sparingly (and it might be good to consolidate them as much as possible).
RE: LDraw.org Official Parts Library Standards: Introduction - Orion Pobursky - 2026-04-23
- I made the editorial changes above.
- I opened an issue for the TOC misalignment
New question: should this intro section contain a glossary?
RE: LDraw.org Official Parts Library Standards: Introduction - N. W. Perry - 2026-04-23
(2026-04-23, 14:46)Orion Pobursky Wrote: New question: should this intro section contain a glossary?
I don't think so, that should appear on its own at the end. (You would still have ready access to it at any time from the TOC sidebar.)
Couldn't hurt to have links in the text to glossary entries, though.
RE: LDraw.org Official Parts Library Standards: Introduction - Travis Cobbs - 2026-04-23
Typo:
Quote:Such part are not required to be edited...
Make "part" plural.
RE: LDraw.org Official Parts Library Standards: Introduction - Orion Pobursky - 2026-04-23
(2026-04-23, 17:51)Travis Cobbs Wrote: Typo:
Make "part" plural.
Fixed.
RE: LDraw.org Official Parts Library Standards: Introduction - Peter Blomberg - 2026-05-07
Sorry I'm late to the party.
The Introduction states the purpose as follows: "The purpose of this document is to describe the requirements for parts, subparts, primitives, and texture images to be included in the LDraw.org Parts Library."
What about assemblies? Stickers?
Is this an introduction to all four specifications currently in the 'active' section or is this somehow separate from those?
As an introduction, I would expect to see some kind of overview of the contents, i.e. the major sections to be covered in the subsequent documents. E.g. "The Official Parts Library Standards compose of a, b, c, and d.
Section a...
Section b...
Section c...
Section d..."