Communicating Within the Ostro™ Project Community🔗

As the Ostro Project community grows, it’s important to share design and implementation ideas with the whole community. Whenever possible, sharing information should be the default and not the exception. That means having discussions in public forums and ensuring team and community members not present get the same information. Exceptions are legal and human issues, which may have to be discussed more privately.

This technical note offers some communication guidelines we, as a community, should work by. You’ll find a summary of resources and community support systems in Ostro™ Project Access and Community Support Resources.

Email and Mailing Lists🔗

Mailing lists are a convenient way to communicate with Ostro project members as well as other developers interested in the Ostro OS. These lists are perhaps the most convenient way to track developer discussions and to ask your own support questions to the Ostro OS community. You can find a list of the available mailing lists and how to subscribe on https://lists.ostroproject.org

You can also read through the mailing list archives to follow past posts and discussions.

If you need someone specific to respond, include them explicitly in the recipient list (because then it is more likely to be in the main inbox of that recipient) and call out his or her name early in the email. Group-reply to all emails because there might be participants who are not subscribed to the mailinglist.

The mailing list automatically archives the mail thread, so trim away old content and only keep the part that you are replying to. Inline replies are preferred.

Documents🔗

When writing something which will need to be ratified as an official part of the Ostro OS, create or modify a reStructuredText .rst file in one of the sub-folders in the meta-ostro repository doc folder and submit the change for review in a pull request. We’re using the Sphinx document generation tools for processing and creating our technical documentation web content found at http://ostroproject.org/documentation. You can find some helpful writing and formatting tips in the Documentation Guidelines for the Ostro™ Project tech note.

Meetings🔗

If a meeting is open to all interested parties, add the mailing lists as an optional participant.

Remember to write meeting minutes and send a pointer to them via email, copying a mailing list. If possible, include the minutes or at least a summary of them in that email so the recipient can decide whether the minutes are relevant for them without having to leave their mail reader.

Chat🔗

You can chat online with the Ostro OS developer community and other users in our IRC channel #ostroproject on the freenode.net IRC server. You can use the http://webchat.freenode.net web client or use a client-side application such as pidgin. Communication on IRC is immediate but transient, making it good for meetings or a quick discussion. (IRC discussions are not recorded so it’s better to use the mailing list for open discussions with the community of developers.)