This document describes the steps for creating a tutorial for conda-build.
- Copy the template: https://github.com/conda/conda-build/tree/main/docs/source/resources/tutorial-template.rst.
- Replace the italicized text with your tutorial content, following the :doc:`writing style guide <style-guide>`.
- Review other :doc:`tutorials <../user-guide/tutorials/index>` for additional guidance.
- Contact us at documentation@anaconda.com for help.
Provide descriptions of the tutorial's:
- Purpose.
- Benefits.
- Application.
- Who is your audience?
- What skills or prior knowledge do they need?
- How will they use this tutorial?
Before you start, check the :ref:`prereqs`.
Provide descriptions of and links to requisite programs.
If you're using several technical terms that your readers may be unfamiliar with, provide a glossary of key terms.
Glossary | Definition |
---|---|
Term 1 | Term 1 defined |
Term 2 | Term 2 defined |
Term 3 | Term 3 defined |
- Provide descriptive titles for each section.
- Identify the major tasks.
- Separate each major task into subtasks.
- Write a series of steps that walk the user through each subtask.
- Provide links to related content.
- Add final notes for how to expand upon the tutorial.