Skip to content

Conversation

Copy link

Copilot AI commented Jan 22, 2026

Adds a new FAQ guide to help users understand how to release and distribute their Elixir Desktop applications.

Changes Made

  • Created guides/faq.md: New FAQ document that includes:

    • Instructions on using mix desktop.installer to create platform-specific installers for Windows, macOS, and Linux
    • Explanation of why mix release is not the recommended approach for Desktop applications
    • Information about the types of installer files generated for each platform
    • Links to other getting started guides for new users
  • Updated mix.exs: Added the FAQ to the documentation extras so it appears in the generated documentation alongside existing guides

Context

This addresses the original issue where users were confused about which command to use for releasing their Desktop applications and which files to distribute. The FAQ provides clear, beginner-friendly guidance on the correct workflow using mix desktop.installer instead of the standard mix release command.

The content is written to be generally applicable and follows the existing documentation structure and style.

Original prompt

This section details on the original issue you should resolve

<issue_title>Releasing & Distributing</issue_title>
<issue_description>Great work on creating this super easy to setup 🦾 just got a couple of questions around releasing and distributing (because I don't know much :P) - once I run mix release which file can I click on to run my program? It should be that file that I should be able to distribute to my users.

I think the documentation should include a section around which command to use (mix release) and which file to select for noobies like me.</issue_description>

<agent_instructions>Create a faq.md in the guides section and add this question / answer to it. Consolidate the question and answer to be more generally applicable.</agent_instructions>

Comments on the Issue (you are @copilot in this section)

@dominicletz You're right. The command to create the windows/macos/linux installer is `mix dekstop.installer`

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

@dominicletz
Copy link
Collaborator

@copilot retry

Co-authored-by: dominicletz <2987674+dominicletz@users.noreply.github.com>
Copy link
Author

Copilot AI commented Jan 22, 2026

@copilot retry

I've created the FAQ guide at guides/faq.md with information about releasing and distributing Desktop applications using mix desktop.installer. The guide addresses the original issue and consolidates the question/answer to be more generally applicable. Changes committed in 6990043.

Copilot AI changed the title [WIP] Add FAQ section for releasing and distributing Add FAQ section for releasing and distributing Jan 22, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Releasing & Distributing

2 participants