maximum dimensions and (mass) of the piece (helps conceptualize the size and size required for transport
Notes are good when needed, but should be kept to minimum and be written in clear language (for example Simplified Technical English)
For assemblies:
You need some kind of a Bill of Materials. It can be either in the drawing, or as separate file like you now have the excel. If you have it as a separate document you need something to link the two documents. For example the BoM numbers and then you show with balloons in the assembly drawing what goes where.
The references in the BOM should be completely and generally specify a manufacturer and their unique code, for standard parts you have a standard reference, material and size (for example screws)
It might be useful to make subassemblies, if there are too many components in the main assembly level.
You will need a again the maximum size and weight. If there are some functional dimensions it can be useful to add them. For example the alignment range.
Define torque force for screws
For all parts:
the mass of the component
the reference to the general tolerance (ISO 2768-xy) where xy is the class. I suggest you start with class mK (i.e. ISO 2768-mK)
general surface quality requirement
the tolerances for unmarked edges: ISO 13715 + the values
material + possible surface treatments
For fully custom parts you need the above + define all of the features fully with dimensions
For customized parts: you should note clearly the starting part and manufacturer + all of the modification done. You don't have to dimension all of the existing part, but there should be the general dimensions and dimensions locating the modified features
Files storage: Store all project files in EDMS; git is not the right place:)
Licensing: the PCB files seem to be copyright CERN and licensed under CERN OHL v1.2. It would be good to update them to CERN OHL v2, which means we need to choose a variant. For the PCBs, the W variant would allow us to cater for the fact that the KiCad libs might be proprietary or under some other open-source licencing regime, yet still benefit from improvements in the PCB design. For mechanics, W could also be a good compromise: changes to a certain piece would need to be released, but that piece could be used in a proprietary crate. To be discussed. There is also the problem of how to include the licensing information in the files. For PCB schematics and layout, it is easy to add a text box in the drawing itself. For mechanical 2D drawings, that would seem the best option as well. For 3D models, either we find some metadata field inside the file to embed that information or we use an external file with the same file name as the design and the extension ".license" as is done in the REUSE guidelines. In any case, copyright must clearly be attributed to CERN, and the licensing information must be easily accessible and findable for users of the designs.