Using the Help Function in the Notebooks and Query Browser
You can use help:relation
(where relation represents a specific name) to display a relation’s documentation rendered from the docstring’s markdown content. This allows you to display the instructions for using a relation when working with Rel, and makes the Rel code self-documenting.
The function help
will render the relation’s docstring, if it exists, as rich HTML. When working with the SDKs (opens in a new tab), where no HTML rendering is available, you can also use docstring to get a relation’s docstring
information as a string.
All of the relations defined in our Rel libraries have docstrings that can be viewed using the help
or docstring
functionality. For example, help:load_csv
displays the documentation for load_csv
:
You can also add your own documentation by adding docstrings to your relations. To do this, use the Install cell in the RAI Notebook, add doc"""
above your relation, and write your comment in markdown before closing the section with """
.
If you then use help:myrelation
, the system will render the docstring you have created, allowing you or others to refer to further details documented for your Rel code.
Related Posts
Spread Functionality Added to the Rel Standard Library
Now supporting a spread functionality with two strategies: even spread and ratio spread.
Retail Recovery - Thriving in the New Normal
Semantic Optimization makes your complex data workloads more efficient, which in turn improves overall system performance and scalability.