\n","children":[{"type":"text","text":""}]},{"type":"p","children":[{"type":"text","text":"You can use "},{"type":"text","text":"help:relation","code":true},{"type":"text","text":" (where "},{"type":"text","text":"relation","italic":true},{"type":"text","text":" 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."}]},{"type":"p","children":[{"type":"text","text":"The function "},{"type":"text","text":"help","code":true},{"type":"text","text":" will render the relation’s docstring, if it exists, as rich HTML. When working with the "},{"type":"a","url":"https://docs.relational.ai/rkgms/sdk","title":null,"children":[{"type":"text","text":"SDKs"}]},{"type":"text","text":", where no HTML rendering is available, you can also use docstring to get a relation’s "},{"type":"text","text":"docstring","code":true},{"type":"text","text":" information as a string."}]},{"type":"p","children":[{"type":"text","text":"All of the relations defined in our Rel libraries have docstrings that can be viewed using the "},{"type":"text","text":"help","code":true},{"type":"text","text":" or "},{"type":"text","text":"docstring","code":true},{"type":"text","text":" functionality. For example, "},{"type":"text","text":"help:load_csv","code":true},{"type":"text","text":" displays the documentation for "},{"type":"text","text":"load_csv","code":true},{"type":"text","text":":"}]},{"type":"mdxJsxFlowElement","name":"ImgFig","children":[{"type":"text","text":""}],"props":{"src":"/blog/using-the-help-function-in-the-notebooks-and-query-browser/help-load-csv.png","width":"100%","alt":"help-load-csv"}},{"type":"p","children":[{"type":"text","text":"You can also add your own documentation by adding docstrings to your relations. To do this, use the "},{"type":"text","text":"Install","italic":true},{"type":"text","text":" cell in the RAI Notebook, add "},{"type":"text","text":"doc\"\"\"","code":true},{"type":"text","text":" above your relation, and write your comment in markdown before closing the section with "},{"type":"text","text":"\"\"\"","code":true},{"type":"text","text":"."}]},{"type":"mdxJsxFlowElement","name":"ImgFig","children":[{"type":"text","text":""}],"props":{"src":"/blog/using-the-help-function-in-the-notebooks-and-query-browser/my-relation.png","width":"100%","alt":"my-relation"}},{"type":"p","children":[{"type":"text","text":"If you then use "},{"type":"text","text":"help:myrelation","code":true},{"type":"text","text":", the system will render the docstring you have created, allowing you or others to refer to further details documented for your Rel code."}]}],"_content_source":{"queryId":"src/content/resources/using-the-help-function-in-the-notebooks-and-query-browser.mdx","path":["resource","body"]}},"_content_source":{"queryId":"src/content/resources/using-the-help-function-in-the-notebooks-and-query-browser.mdx","path":["resource"]}}},"errors":null,"query":"\n query resource($relativePath: String!) {\n resource(relativePath: $relativePath) {\n ... on Document {\n _sys {\n filename\n basename\n breadcrumbs\n path\n relativePath\n extension\n }\n id\n }\n ...ResourceParts\n }\n}\n \n fragment ResourceParts on Resource {\n __typename\n title\n description\n date\n image\n categories\n authors {\n __typename\n name\n link\n }\n seo {\n __typename\n keywords\n description\n image\n image_alt\n canonical_url\n author\n published\n modified\n language\n robots\n site_name\n content_type\n }\n body\n}\n ","variables":{"relativePath":"using-the-help-function-in-the-notebooks-and-query-browser.mdx"}},"src/content/meta/meta.md":{"data":{"meta":{"_sys":{"filename":"meta","basename":"meta.md","breadcrumbs":["meta"],"path":"src/content/meta/meta.md","relativePath":"meta.md","extension":".md"},"id":"src/content/meta/meta.md","__typename":"Meta","banner":{"__typename":"MetaBanner","enabled":true,"content":{"type":"root","children":[{"type":"p","children":[{"type":"text","text":"Check out "},{"type":"a","url":"/resources/highlights-of-relationalai-at-snowflake-data-cloud-summit-2024","title":"SF summit highlights","children":[{"type":"text","text":"highlights"}]},{"type":"text","text":" of RelationalAI at "},{"type":"text","text":"Snowflake's Data Cloud Summit 2024!","bold":true}]}],"_content_source":{"queryId":"src/content/meta/meta.md","path":["meta","banner","content"]}},"_content_source":{"queryId":"src/content/meta/meta.md","path":["meta","banner"]}},"header":{"__typename":"MetaHeader","links":[{"__typename":"MetaHeaderLinks","text":"Product","url":"/product","style":"default","_content_source":{"queryId":"src/content/meta/meta.md","path":["meta","header","links",0]}},{"__typename":"MetaHeaderLinks","text":"Company","url":"/company","style":"default","_content_source":{"queryId":"src/content/meta/meta.md","path":["meta","header","links",1]}},{"__typename":"MetaHeaderLinks","text":"Docs","url":"/docs","style":"default","_content_source":{"queryId":"src/content/meta/meta.md","path":["meta","header","links",2]}},{"__typename":"MetaHeaderLinks","text":"Resources","url":"/resources/all/1","style":"default","_content_source":{"queryId":"src/content/meta/meta.md","path":["meta","header","links",3]}},{"__typename":"MetaHeaderLinks","text":"Get Started","url":"/get-started","style":"cta","_content_source":{"queryId":"src/content/meta/meta.md","path":["meta","header","links",4]}}],"_content_source":{"queryId":"src/content/meta/meta.md","path":["meta","header"]}},"footer":{"__typename":"MetaFooter","sections":[{"__typename":"MetaFooterSections","name":"Product","links":[{"__typename":"MetaFooterSectionsLinks","text":"Overview","url":"/product","_content_source":{"queryId":"src/content/meta/meta.md","path":["meta","footer","sections",0,"links",0]}},{"__typename":"MetaFooterSectionsLinks","text":"Use Cases","url":"/product#for-problems-that-matter","_content_source":{"queryId":"src/content/meta/meta.md","path":["meta","footer","sections",0,"links",1]}},{"__typename":"MetaFooterSectionsLinks","text":"Capabilities","url":"/product#a-new-toolset","_content_source":{"queryId":"src/content/meta/meta.md","path":["meta","footer","sections",0,"links",2]}}],"_content_source":{"queryId":"src/content/meta/meta.md","path":["meta","footer","sections",0]}},{"__typename":"MetaFooterSections","name":"Resources","links":[{"__typename":"MetaFooterSectionsLinks","text":"Documentation","url":"/docs/getting_started","_content_source":{"queryId":"src/content/meta/meta.md","path":["meta","footer","sections",1,"links",0]}},{"__typename":"MetaFooterSectionsLinks","text":"News","url":"/resources/news/1","_content_source":{"queryId":"src/content/meta/meta.md","path":["meta","footer","sections",1,"links",1]}},{"__typename":"MetaFooterSectionsLinks","text":"Research","url":"/resources/research/1","_content_source":{"queryId":"src/content/meta/meta.md","path":["meta","footer","sections",1,"links",2]}},{"__typename":"MetaFooterSectionsLinks","text":"Releases","url":"/resources/releases/1","_content_source":{"queryId":"src/content/meta/meta.md","path":["meta","footer","sections",1,"links",3]}}],"_content_source":{"queryId":"src/content/meta/meta.md","path":["meta","footer","sections",1]}},{"__typename":"MetaFooterSections","name":"About Us","links":[{"__typename":"MetaFooterSectionsLinks","text":"Our Company","url":"/company","_content_source":{"queryId":"src/content/meta/meta.md","path":["meta","footer","sections",2,"links",0]}},{"__typename":"MetaFooterSectionsLinks","text":"Contact Us","url":"/get-started","_content_source":{"queryId":"src/content/meta/meta.md","path":["meta","footer","sections",2,"links",1]}},{"__typename":"MetaFooterSectionsLinks","text":"Careers","url":"/careers","_content_source":{"queryId":"src/content/meta/meta.md","path":["meta","footer","sections",2,"links",2]}},{"__typename":"MetaFooterSectionsLinks","text":"Legal","url":"/legal","_content_source":{"queryId":"src/content/meta/meta.md","path":["meta","footer","sections",2,"links",3]}},{"__typename":"MetaFooterSectionsLinks","text":"GDPR","url":"/gdpr","_content_source":{"queryId":"src/content/meta/meta.md","path":["meta","footer","sections",2,"links",4]}},{"__typename":"MetaFooterSectionsLinks","text":"Security & Trust","url":"https://trust.relational.ai/","_content_source":{"queryId":"src/content/meta/meta.md","path":["meta","footer","sections",2,"links",5]}}],"_content_source":{"queryId":"src/content/meta/meta.md","path":["meta","footer","sections",2]}}],"socials":[{"__typename":"MetaFooterSocials","text":"GitHub","url":"https://github.com/RelationalAI","icon":"https://assets.tina.io/91d76337-e55d-4722-acb5-3106adb895b6/img/logos/github.png","_content_source":{"queryId":"src/content/meta/meta.md","path":["meta","footer","socials",0]}},{"__typename":"MetaFooterSocials","text":"LinkedIn","url":"https://www.linkedin.com/company/relationalai/about","icon":"https://assets.tina.io/91d76337-e55d-4722-acb5-3106adb895b6/img/logos/linkedin.png","_content_source":{"queryId":"src/content/meta/meta.md","path":["meta","footer","socials",1]}},{"__typename":"MetaFooterSocials","text":"Twitter","url":"https://twitter.com/relationalai","icon":"https://assets.tina.io/91d76337-e55d-4722-acb5-3106adb895b6/img/logos/twitter.png","_content_source":{"queryId":"src/content/meta/meta.md","path":["meta","footer","socials",2]}}],"_content_source":{"queryId":"src/content/meta/meta.md","path":["meta","footer"]}},"_content_source":{"queryId":"src/content/meta/meta.md","path":["meta"]}}},"errors":null,"query":"\n query meta($relativePath: String!) {\n meta(relativePath: $relativePath) {\n ... on Document {\n _sys {\n filename\n basename\n breadcrumbs\n path\n relativePath\n extension\n }\n id\n }\n ...MetaParts\n }\n}\n \n fragment MetaParts on Meta {\n __typename\n banner {\n __typename\n enabled\n content\n }\n header {\n __typename\n links {\n __typename\n text\n url\n style\n }\n }\n footer {\n __typename\n sections {\n __typename\n name\n links {\n __typename\n text\n url\n }\n }\n socials {\n __typename\n text\n url\n icon\n }\n }\n}\n ","variables":{"relativePath":"./meta.md"}}};
globalThis.tina_info = tina;
})();
Using the Help Function in the Notebooks and Query Browser · RelationalAI
Check out highlights of RelationalAI at Snowflake's Data Cloud Summit 2024!
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, 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.