/usr/share/help/de/hig/primary-windows.page is in gnome-devel-docs 3.14.1-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 | <?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="primary-windows" xml:lang="de">
<info>
<link type="guide" xref="patterns" group="primary-windows"/>
<credit type="author">
<name>Allan Day</name>
<email>aday@gnome.org</email>
</credit>
<include xmlns="http://www.w3.org/2001/XInclude" href="legal.xml"/>
<mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
<mal:name>Christian Kirbach</mal:name>
<mal:email>christian.kirbach@gmail.com</mal:email>
<mal:years>2014</mal:years>
</mal:credit>
</info>
<title>Primary windows</title>
<media type="image" mime="image/svg" src="figures/patterns/primary-windows.svg"/>
<p>Primary windows are the basic high-level container for your application user interface, and should present the core functionality of your application.</p>
<section id="when-to-use">
<title>When to use</title>
<p>Every application should have at least one primary window associated with it.</p>
</section>
<section id="application-types">
<title>Application types</title>
<p>There are two main models for primary windows:</p>
<section id="single-instance-applications">
<title>Single instance applications</title>
<p>Single instance applications have a single primary window. This model is common for messaging applications, such as email, chat, or contacts.</p>
</section>
<section id="multiple-instance-applications">
<title>Multiple instance applications</title>
<p>Multiple instance applications can have multiple primary windows. Typically, each primary window will be identical. Multi-instance applications are frequently viewers or editors, such as for documents or images.</p>
<p>Both single and multiple instance applications can allow multiple content items to be opened, either through the use of <link xref="tabs">tabs</link> or browser-style navigation. However, multiple windows do offer additional capabilities, which include:</p>
<list>
<item><p>Viewing several content items alongside each other.</p></item>
<item><p>Placing content on different workspaces.</p></item>
<item><p>Organizing sets of content into different windows (if using tabs).</p></item>
</list>
</section>
</section>
<section id="general-guidelines">
<title>General guidelines</title>
<list>
<item><p>If your application isn’t running and its launcher is activated, a single primary window should be displayed. Do not show multiple windows when your application is initially launched.</p></item>
<item><p>If your application launcher is selected while your application is running, all its primary windows should be displayed.</p></item>
<item><p>Primary windows should host the main functionality of your application. Do not rely on dialogs or secondary windows in order to present basic functionality.</p></item>
<item><p>Primary windows should be independent - closing one primary window should not result in other primary windows being closed.</p></item>
<item><p>Dialog windows should always be dependent on a primary window. See the <link xref="dialogs">dialogs page</link> guidelines.</p></item>
<item><p>Your application should cease to run when all its primary windows have been closed.</p></item>
<item><p><gui>Quit</gui> should close all primary windows.</p></item>
</list>
</section>
</page>
|