dotnet / dotnet/docs-maui

Add some docs to talk about app versioning

Open
#1,516 0 comments 0 reactions 0 assignees View on GitHub
doc-idea Pri1
Dominant language
No language data
Stars
282
Forks
265
Avg merge
2d 2h
Merged PRs (30d)
19

Description

Right now there seems to be not much saying what the `ApplicationVersion` and `ApplicationDisplayVersion` properties do and how they work for a cross-platform level.

In addition to this, these numbers are retrieved using maui essentials, so that may be useful.

Also, Windows is special... They do not support the 2 system, so we "fake" it by using the 4 part version for windows:

Full app version = `"$(ApplicationDisplayVersion).$(ApplicationVersion)`

We then split it up later in essentials. Nasty but it is all we have.

Contributor guide

Open the contributing guide

Research direction

Use the ApplicationVersion and ApplicationDisplayVersion properties named in the issue as the documentation scope, including how MAUI Essentials retrieves them. Document the cross-platform behavior and the Windows four-part version workaround, then check the existing documentation for the right place and verify that the explanation covers the stated full app version format.

Written by the indexing model from the issue text.

Assessment

Tech stack
csharp
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.