This file is indexed.

/usr/share/help/cs/programming-guidelines/additional-materials.page is in gnome-devel-docs 3.28.0-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
<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" xmlns:its="http://www.w3.org/2005/11/its" type="guide" style="task" id="additional-materials" xml:lang="cs">

  <info>
    <link type="guide" xref="index#references"/>
    
    <credit type="author copyright">
      <name>Federico Mena-Quintero</name>
      <email its:translate="no">federico@gnome.org</email>
      <years>2013</years>
    </credit>

    <include xmlns="http://www.w3.org/2001/XInclude" href="cc-by-sa-3-0.xml"/>

    <desc>Pokyny k dalším stylům a knihy o organizování svobodných softwarových projektů</desc>
  </info>

  <title>Doplňující materiály</title>

  <p>Zde uvádíme odkazy na další materiály, které by vás mohly zajímat. Dozvíte se v nich, jak pracovat ve velkých týmech vývojářů svobodného softwaru roztroušených po celém světě a obecně o kvalitním stylu programování.</p>

  <list>
    <item>
      <p><link href="http://producingoss.com/">Producing Open Source Software</link> od Karla Fogela. Jedná se o opravdu skvělou knihu o dobrých zvycích, kterých by se měli držet projekty svobodného softwaru. Zabývá se <em>sociální stránkou</em> projektů: jak se chovat k přispěvatelům, jak organizovat a moderovat komunikaci, jak řídit neziskové nadace. Jestliže jste se někdy sami sebe zeptali: „co bych měl v projektu udělat v $SITUACE_S_LIDMI?“, dá vám tato kniha odpověď.</p>
    </item>

    <item>
      <p><link href="http://www.gnu.org/prep/standards/">GNU Coding Standards</link>. Jedná se o starší dokument, který může ale i dnes poskytnout cenné rady. Rozebírá styl kódování v jazyce C, problémy při zacházení se zásuvnými moduly, běžné volby názvů pro programy příkazové řádky, zvyklosti pro Makefile a některými detaily okolo GNU, jako je používání Texinfo pro dokumentaci.</p>
    </item>

    <item>
      <p><link href="https://www.kernel.org/doc/Documentation/process/coding-style.rst">Linux Kernel Coding Style</link>. Vysvětluje důvody pro „velké odsazení“, umísťování závorek, stručné, ale při tom jednoznačné pojmenování a opouštění funkcí v jediném bodě.</p>
    </item>
  </list>
</page>