# Wiki: Conventions Quick Links

**URL:** <https://farmos.discourse.group/t/wiki-conventions-quick-links/1518>\
**Category:** Conventions\
**Created:** [February 8, 2023, 8:16pm UTC](https://farmos.discourse.group/t/wiki-conventions-quick-links/1518 "2023-02-08T20:16:19Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![jgaehring](https://yyz2.discourse-cdn.com/free1/user_avatar/farmos.discourse.group/jgaehring/32/927_2.png) [@jgaehring](https://farmos.discourse.group/u/jgaehring)\
**Post date:** [February 8, 2023, 8:16pm UTC](https://farmos.discourse.group/t/wiki-conventions-quick-links/1518/1 "2023-02-08T20:16:19Z")

</div>

# Wiki: farmOS Conventions

A collection of useful links and other information regarding farmOS Conventions.

## General documentation & drafts

General information on what conventions are, how they are to be structured and used. As of Feb 2023, however, there is no “official” standard, strictly formalized specification, or governing body to determine what those are.

- [“Conventions”](https://farmos.org/model/convention/), from the documentation on [farmos.org](http://farmos.org), as a part of the [farmOS Data Model](https://farmos.org/model/).
- [DRAFT: OpenTEAM Conventions Specification](https://gitlab.com/OpenTEAMAg/OpenTEAM-Technology/-/tree/master/conventions), from the OpenTEAM GitLab repository.

## Published & proposed conventions

The conventions themselves, currently being proposed for eventual publication.

- _(proposed)_ Repository for farmOS core conventions and template: [GitHub - mstenta/farmOS-conventions](http://github.com/mstenta/farmOS-conventions/)
- _(proposed)_ Roadmap: [Roadmap · Issue #1 · mstenta/farmOS-conventions · GitHub](https://github.com/mstenta/farmOS-conventions/issues/1)
- _(proposed)_ Convention template: [farmOS-conventions/template/index.md at template · mstenta/farmOS-conventions · GitHub](https://github.com/mstenta/farmOS-conventions/blob/template/template/index.md)
- _(proposed)_ Example “Soil test” core convention: [farmOS-conventions/conventions/farmOS/soil-test/1.0/index.md at wip · mstenta/farmOS-conventions · GitHub](https://github.com/mstenta/farmOS-conventions/blob/wip/conventions/farmOS/soil-test/1.0/index.md)
- _(proposed)_ Example “Pasture Condition Score” community convention: [farm\_nrcs/conventions/NRCS/pasture-condition-score/1.0/index.md at 2.x-pcs · mstenta/farm\_nrcs · GitHub](https://github.com/mstenta/farm_nrcs/blob/2.x-pcs/conventions/NRCS/pasture-condition-score/1.0/index.md)

## Community Calls & Working Groups

- [Common Farm Convention Biweekly Community Call](https://farmos.discourse.group/t/common-farm-convention-biweekly-community-call/1914)
  - **Alternate Thursdays, 1:00pm-1:45pm EST**
  - **Meeting Link:** [https://meet.jit.si/farmos-dev](https://www.google.com/url?q=https://meet.jit.si/farmos-dev&sa=D&source=calendar&ust=1709993174389086&usg=AOvVaw26OjZhDV_1BeVLUjKObIM_)
  - **Description:** We’ve been gathering every other Thursday after the farmOS dev call to chat about “ag data wallet / common farm format / FarmOS Conventions / schema distribution gitlab / etc… We’ll call this all Conventions for simplicity”

- **Past Meetings (forum tag):** #conventions-meeting

## Discussion

Much of the rationale behind farmOS conventions has been archived in public discussions here on the farmOS forum and in various git repositories. Many more topics can be found under the [Conventions category](https://farmos.discourse.group/c/conventions/11) here on the forum, but these threads should trace the main arch its development. They are organized in reverse chronological order according to their first posts, although they may all have more current and ongoing comments.

- 2022-06-07T04:00:00Z - [Documenting conventions](https://farmos.discourse.group/t/documenting-conventions/1263) **(PRIMARY FORUM TOPIC FOR DISCUSSION)**
- 2021-08-31T04:00:00Z - [Conventions as config entities](https://farmos.discourse.group/t/conventions-as-config-entities/902)
- 2021-03-04T05:00:00Z - [https://gitlab.com/OpenTEAM1/OpenTEAM-Technology/-/issues/70](https://gitlab.com/OpenTEAM1/OpenTEAM-Technology/-/issues/70)
- 2020-11-18T05:00:00Z - [farmOS Conventions notes · Wiki · our-sci / partners / Research Farm Roadmap · GitLab](https://gitlab.com/our-sci/partners/research-farm-roadmap/-/wikis/farmOS-Conventions-notes)
- 2020-11-06T05:00:00Z - [Creating a standard 'interpretation' layer on top of core farmOS schema](https://farmos.discourse.group/t/creating-a-standard-interpretation-layer-on-top-of-core-farmos-schema/533)
- 2020-05-19T04:00:00Z - [How SurveyStack uses farmOS · Wiki · our-sci / partners / Research Farm Roadmap · GitLab](https://gitlab.com/our-sci/partners/research-farm-roadmap/-/wikis/How-SurveyStack-uses-farmOS)

Conventions are also occasionally discussed in the [farmOS Community Calls](https://farmos.org/community/monthly-call/), held on the second Wednesday of each month. Specific proposals or inquiries can be added to the agenda for any [upcoming call](https://farmos.discourse.group/tag/community-call).

---

<div class="post-metadata">

**Author:** ![mstenta](https://yyz2.discourse-cdn.com/free1/user_avatar/farmos.discourse.group/mstenta/32/4_2.png) [@mstenta](https://farmos.discourse.group/u/mstenta)\
**Post date:** [February 8, 2023, 8:39pm UTC](https://farmos.discourse.group/t/wiki-conventions-quick-links/1518/2 "2023-02-08T20:39:20Z")

</div>

Thanks for starting this @jgaehring! I created a dedicated “Conventions” category, moved this topic to it, and pinned it.

How about we rename this to “Wiki: Conventions Quick Links” and make that the focus? I’ll add some quick links from [Documenting conventions](https://farmos.discourse.group/t/documenting-conventions/1263) as a start, but feel free to modify! I think a quick link wiki topic would be really helpful - and hopefully that captures the spirit of what you suggested on the call!

---

<div class="post-metadata">

**Author:** ![mstenta](https://yyz2.discourse-cdn.com/free1/user_avatar/farmos.discourse.group/mstenta/32/4_2.png) [@mstenta](https://farmos.discourse.group/u/mstenta)\
**Post date:** [February 8, 2023, 8:39pm UTC](https://farmos.discourse.group/t/wiki-conventions-quick-links/1518/3 "2023-02-08T20:39:39Z")

</div>



---

<div class="post-metadata">

**Author:** ![jgaehring](https://yyz2.discourse-cdn.com/free1/user_avatar/farmos.discourse.group/jgaehring/32/927_2.png) [@jgaehring](https://farmos.discourse.group/u/jgaehring)\
**Post date:** [February 9, 2023, 12:38am UTC](https://farmos.discourse.group/t/wiki-conventions-quick-links/1518/4 "2023-02-09T00:38:57Z")

</div>

Thanks for doing the hard work of getting the actual info filled in!

For reference, when I suggested this today, I kinda had in mind this old wiki from the working group that developed the first published specification of ActivityPub (though they’re no longer active, being superseded by newer groups):

[https://www.w3.org/wiki/Socialwg](https://www.w3.org/wiki/Socialwg)

It seems to have served as a good intro to their WG, what the latest news was, what was their process, how to get engaged, etc. In retrospect, it’s also a great historical document! I just happened to be digging around recently, looking at the history of ActivityPub, and so I guess it was in the back of my mind. Anyways, this looks great!

---

<div class="post-metadata">

**Author:** ![jgaehring](https://yyz2.discourse-cdn.com/free1/user_avatar/farmos.discourse.group/jgaehring/32/927_2.png) [@jgaehring](https://farmos.discourse.group/u/jgaehring)\
**Post date:** [February 10, 2023, 5:06pm UTC](https://farmos.discourse.group/t/wiki-conventions-quick-links/1518/5 "2023-02-10T17:06:05Z")

</div>

Just reorganized this a bit, to give a little more context for anyone new coming to the topic. Might also add a link for the community calls, for people interested in real-time discussion.
