Skip to content

Commit

Permalink
Add more details to the User Guide and Data Model docs about farm ass…
Browse files Browse the repository at this point in the history
…ets.
  • Loading branch information
mstenta committed Feb 1, 2024
1 parent c00cf3e commit 0d0ef9a
Show file tree
Hide file tree
Showing 2 changed files with 15 additions and 1 deletion.
9 changes: 9 additions & 0 deletions docs/guide/mapping.md
Expand Up @@ -20,6 +20,15 @@ designated as a location.
When you're done modifying your area, remember to click the Save button at the
bottom of the page to save your changes.

## Farm Assets

In some situations, it may be useful to organize Land Assets under one or more
Farm Assets, which represent different locations or operations that are
managed independently. farmOS includes a Farm Asset type in an optional module
that can be turned on in those scenarios. Land Assets (and other locations) can
be organized under Farm Assets in the location hierarchy to make their
relationship clear.

## Map controls

### Zooming
Expand Down
7 changes: 6 additions & 1 deletion docs/model/type/asset.md
Expand Up @@ -26,7 +26,7 @@ included with farmOS define the following Asset types:
- Water
- Material
- Group*
- Farm
- Farm*

*Group Assets are unique in that they can "contain" other Assets as "group
members". This is a flexible feature that can be used for many purposes. One
Expand All @@ -36,6 +36,11 @@ to see all the Groups that an Asset was a member of in the past, when/why they
were moved, etc. See [farmOS Group Membership Logic](/model/logic/group) for
more information.

*Farm Assets can be used to model multiple "farms" within a single farmOS
instance/dataset. This can be useful in situations where there are multiple
different locations with their own Land Assets, Equipment Assets, etc, or as a
place to store farm-level data that may not fit nicely in more granular records.

## ID

Each Asset will be assigned two unique IDs in the database: a universally unique
Expand Down

0 comments on commit 0d0ef9a

Please sign in to comment.