@@ -257,14 +257,24 @@ about if you are really sure to make breaking changes to it.**
257257Here are some simple recommendations which help to avoid running into troubles
258258due to broken references:
259259
260+ * **Fully finish library elements before starting to use them (_right first
261+ time_)!** Do not just create a quick&dirty package & corresponding device,
262+ add them to a project, and then iterate those library elements many times
263+ to get them finished & right. It is no problem to correct smaller things
264+ later (silkscreen drawings, pad sizes, MPNs, datasheet URLs etc.), but **the
265+ fundamental things (number of pads, package & component of a device, pinout
266+ etc.) need to be done right from the beginning on.** You can save yourself
267+ a lot of headaches (and time) if you seriously finish library elements
268+ **one after the other** instead of just hacking around with trial & error.
269+ LibrePCB is not the tool to hack around.
270+ * When the "breaking changes"-banner shows up in the library editor, **do not
271+ click on menu:Unlock[] unless you are 100% sure that the library element
272+ has not been used by another library element or a project yet.** If you
273+ are not 100% sure about this, use the menu:Duplicate[] operation.
274+ * When creating new library elements by copying an existing library element,
275+ **use the _duplicate_ operation, not the _copy_ operation**. Generally,
276+ the _copy_ operation is almost never what you are looking for.
260277* **Never copy/move/modify files on the file system directly.** Always perform
261278 operations in LibrePCB, as LibrePCB will take care of UUID handling then.
262279 As soon as you edit files on the file system directly, there is no safety
263280 net anymore and you can run easily into a hell of a mess.
264- * When creating new library elements by copying an existing library element,
265- **use the _duplicate_ operation, not the _copy_ operation**. Generally,
266- the _copy_ operation is almost never what you are looking for.
267- * When the "breaking changes"-banner shows up in the library editor, **do not
268- click on menu:Unlock[] unless you are 100% sure that the library element
269- has not been used by another library element or a project yet.** If you
270- are not 100% sure about this, use the _Duplicate_ operation.
0 commit comments