From 61101b0568615488aba67c2fb89f76082bac3164 Mon Sep 17 00:00:00 2001 From: stefanorosanelli Date: Mon, 23 Mar 2020 09:48:32 +0100 Subject: [PATCH] chore: reference + formatting --- source/bedita_objects.rst | 13 +++++-------- source/glossary.rst | 2 +- 2 files changed, 6 insertions(+), 9 deletions(-) diff --git a/source/bedita_objects.rst b/source/bedita_objects.rst index 7a45f0f..dbdd2e0 100644 --- a/source/bedita_objects.rst +++ b/source/bedita_objects.rst @@ -3,8 +3,8 @@ Objects in BEdita .. _bedita-objects: -Definition ----------- +Objects definition +------------------ Brief definition: BEdita ``objects`` (see :term:`object`) are the contents of your application, the atoms of the information asset you are building. @@ -48,13 +48,10 @@ An object in BEdita is identified with these capabilities: Other entities in BEdita are called `resources` (see :term:`resource`). Resources have a fixed and predefined structure and can be classified in four basic groups: -* entities like tags, categories, permissions or annotations are special entities - that we assign to objects: they are not objects itself, they rather define object properties +* entities like tags, categories, permissions or annotations are special entities that we assign to objects: they are not objects itself, they rather define object properties * entities like object types, relations, properties are used to design our object model -* other entities like endpoints, configurations, applications, auth providers will be rarely seen directy - by API client developers or applications users: they handle API and project internal behaviors -* roles are special entities used only to give users permissions on objects, endpoints or object types - - they are not objects +* other entities like endpoints, configurations, applications, auth providers will be rarely seen directy by API client developers or applications users: they handle API and project internal behaviors +* roles are special entities used only to give users permissions on objects, endpoints or object types - they are not objects ``Users`` (see :term:`user`) instead are a special object type: you may add properties and relations to other objects, but you may not extend it with a new type. diff --git a/source/glossary.rst b/source/glossary.rst index 6c481ef..8430090 100644 --- a/source/glossary.rst +++ b/source/glossary.rst @@ -12,7 +12,7 @@ Glossary folder - Folders are special :ref:`bedita-objects` used to create tree structures. The concept is similar to folders in computer filesystems. In a :term:`project` you may have multiple folder trees, hence multiple root folders. Each folder, that is not a root folder, has one and only one parent folder. Other object types can instead have more than one parent folder (multifiling). + A folder is a special :term:`object` used to create tree structures. The concept is similar to folders in computer filesystems. In a :term:`project` you may have multiple folder trees, hence multiple root folders. Each folder, that is not a root folder, has one and only one parent folder. Other object types can instead have more than one parent folder (multifiling). json api