[GH-ISSUE #9582] [Documentation] Reorder Customize a Model Section and specify ModelFile file format #6251

Open
opened 2026-04-12 17:41:03 -05:00 by GiteaMirror · 0 comments
Owner

Originally created by @Ashton-Haviland on GitHub (Mar 7, 2025).
Original GitHub issue: https://github.com/ollama/ollama/issues/9582

Would love to work on this one myself if it's possible.

Proposed Changes

Reorder the Customize a Model section.

Reorder the Customize a Model section to have the Customize a Prompt section at the start, as it is the most basic set of instruction and includes the link to more detailed docs, and then including the Import from Safetensors and finally Import from GGUF.

Reasoning

This ordering is to maximize readability and usefulness for low to mid level users looking to create a model with custom prompts, as the user is most likely to have a default Ollama provided model, followed by other potential avenues such as Safetensor/GGUF. The reason for the ordering of the final two items is that the Safetensor section is short and includes a link, allowing users reading the section for custom models(low level users especially), starting from basic, keeping links to extra documentation bundled together.

Specify accepted file formats for ModelFile.

Specify accepted file formats for ModelFile both in the Customize a Model section, to increase flexibility of use and documentation for low level users.

Reasoning

No file format is specified for ModelFile, making it ambiguous what it accepts, and confusing for tech illiterate/low level users.

Originally created by @Ashton-Haviland on GitHub (Mar 7, 2025). Original GitHub issue: https://github.com/ollama/ollama/issues/9582 Would love to work on this one myself if it's possible. # Proposed Changes ## Reorder the **Customize a Model** section. Reorder the **Customize a Model** section to have the **Customize a Prompt** section at the start, as it is the most basic set of instruction and includes the link to more detailed docs, and then including the **Import from Safetensors** and finally **Import from GGUF**. ### Reasoning This ordering is to maximize readability and usefulness for low to mid level users looking to create a model with custom prompts, as the user is most likely to have a default Ollama provided model, followed by other potential avenues such as Safetensor/GGUF. The reason for the ordering of the final two items is that the Safetensor section is short and includes a link, allowing users reading the section for custom models(low level users especially), starting from basic, keeping links to extra documentation bundled together. ## Specify accepted file formats for ModelFile. Specify accepted file formats for ModelFile both in the Customize a Model section, to increase flexibility of use and documentation for low level users. ### Reasoning No file format is specified for ModelFile, making it ambiguous what it accepts, and confusing for tech illiterate/low level users.
GiteaMirror added the documentation label 2026-04-12 17:41:03 -05:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: github-starred/ollama#6251