OganizationConventions¶

These conventions are in brainstorming staging. Feel free to add any thoughts or suggestions.

Naming¶

TBD

Directory Layout¶

The current policy for filenames of data definitions in RST is as follows:

• The directory (relative to the "proto" directory in the project root) in which the proto-file resides should match the package name with all "."s replaced with "/"s
• The filename should match the name of the "primary" message definition (with ".proto" appended)
• There should only be one "primary" message definition in each proto-file
  • Groups of related messages should reside in individual files in a common directory and refer to each other using import

Rationale¶

• Facilitate easy documentation and reuse via import
• Data definitions can be treated as resources with unique URLs
  • These URLs can be derived from a qualified message name
    E.g. .rst.ImageMessage -> https://code.cor-lab.org/svn/rst/trunk/proto/rst/ImageMessage.proto