Skip to content

Clean up datasource configuration docs #332

Closed

Description

@crandmck

From comment by @ebarault in #319:

.. the accessibility of this information could be improved.
As shown below there are two sections discussing the subject: "Attaching models to datasources" and "Understanding datasources", in addition "Understanding datasources" is nested in a section named "Connecting models to datasources", which is much too close to "Attaching models to datasources".

  • Defining models
    ** Attaching models to datasources

  • Connecting models to datasources
    ** Understanding datasources

image

Ideally datasources would require their own top section, and would fit just before Defining models.
The content of Defining datasources would be extracted from the two sub-sections Attaching models to datasources and Understanding datasources.
The Connecting models to datasources section's name should change. It is as of now a melting pot of advanced details and functionalities.
The applicable content would fit in a new top-level Attached models to datasources

So the logical sequence would look like

  • Defining datasources
    ** Datasources: Advanced topics
  • Defining models
  • Attaching models to datasources

Metadata

Metadata

Assignees

Labels

Type

No type

Projects

No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions