You can provide users with documentation on projects in Code Repositories by adding a README file. README files in Code Repositories support Markdown for flexible, easy-to-use formatting and styling.
Edit or add a README.md file to your repository to get started. This page contains information on additional features that can be used to customize a README file.
Code Repositories provides a number of formatting options for READMEs.
You can display an image from your repository inline with the text of a Markdown file by using the following syntax:
![File Name](/transforms-python/path/to/my/file.jpeg)
In order to upload images to a code repository, you will need to clone your repository locally, add the image files to the local repository, and then push the changes to the server.
To mention a Foundry user in your Markdown files, enter their username with the @
symbol as a prefix. This will create a reference to the mentioned user and a direct link to their profile.
@username
You can reference any Foundry resource by pasting its Resource ID directly into the Markdown file for the README. Resources referenced like this will automatically be named and linked to the corresponding resource in platform.
This repository will be deployed to ri.foundry.main.deployed-app.a00000aa-a000-000a-0000-000a0aa0a00a
To create a link to a file within your repository, use the repo://
protocol followed by the file path; for example, repo://transforms-python/src/myproject/datasets/examples.py
. Files referenced like this will automatically open when clicked. This allows you to easily reference and navigate to other files within your repository.
README files support language syntax highlighting in code blocks in order to improve code legibility. To use syntax highlighting, specify the language after the opening code block delimiter as follows:
Copied!1 2
def hello_world(): print("Hello, World!")
You can also create tables using standard Markdown table syntax:
| Header 1 | Header 2 |
| -------- | -------- |
| Cell 1 | Cell 2 |
URLs and email addresses in a README will be automatically converted into clickable links.