<feed xmlns='http://www.w3.org/2005/Atom'>
<title>progmasoft-cpp/Progmasoft_Core_Cpp_Coding_Guidelines/Cpp17, branch docs/guidelines-layout</title>
<subtitle>The C++ style guide of Progmasoft: naming, formatting, language rules, errors, ownership, ABI, testing and tooling.</subtitle>
<link rel='alternate' type='text/html' href='https://git.progmasoft.com/progmasoft-cpp/'/>
<entry>
<title>Use the two names consistently</title>
<updated>2026-11-13T14:38:17+00:00</updated>
<author>
<name>Leitwolf11</name>
</author>
<published>2026-11-13T14:38:17+00:00</published>
<link rel='alternate' type='text/html' href='https://git.progmasoft.com/progmasoft-cpp/commit/?id=aabd11c1321da173918ad48a2ffb7da5e6d90756'/>
<id>aabd11c1321da173918ad48a2ffb7da5e6d90756</id>
<content type='text'>
Progmasoft C/C++ Styles names the repository, where a text speaks of
all of it: the README introduction, the license texts, CONTRIBUTING and
the changelog. Progmasoft Core C++ Coding Guidelines names its C++
guide, and its own documents call it "the guidelines", in the plural
like its name, instead of "the guide" or "this guide"; the verbs follow.
Dated changelog entries keep their wording. Paragraphs that grew past
120 columns are rewrapped; every link and anchor still resolves.

Co-Authored-By: Claude Opus 5.5 &lt;noreply@anthropic.com&gt;
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Progmasoft C/C++ Styles names the repository, where a text speaks of
all of it: the README introduction, the license texts, CONTRIBUTING and
the changelog. Progmasoft Core C++ Coding Guidelines names its C++
guide, and its own documents call it "the guidelines", in the plural
like its name, instead of "the guide" or "this guide"; the verbs follow.
Dated changelog entries keep their wording. Paragraphs that grew past
120 columns are rewrapped; every link and anchor still resolves.

Co-Authored-By: Claude Opus 5.5 &lt;noreply@anthropic.com&gt;
</pre>
</div>
</content>
</entry>
<entry>
<title>Lay the guide out as Common, Cpp17 and Cpp20 with an index</title>
<updated>2026-11-13T14:21:51+00:00</updated>
<author>
<name>Leitwolf11</name>
</author>
<published>2026-11-13T14:21:51+00:00</published>
<link rel='alternate' type='text/html' href='https://git.progmasoft.com/progmasoft-cpp/commit/?id=cb3d4d6efce480ebbffeba5bf96c2f58396d7466'/>
<id>cb3d4d6efce480ebbffeba5bf96c2f58396d7466</id>
<content type='text'>
The guide moves to Progmasoft_Core_Cpp_Coding_Guidelines/:

- Common/ holds the thirteen chapters, which apply to C++17 and C++20
  alike. Where a chapter used a C++20 feature, it now states the rule
  for both versions and links to the page of each.
- Cpp20/LANGUAGE.md holds the rules that use C++20 features: building
  with -std=c++20, designated initializers, consteval and constinit,
  std::bit_cast, concepts, defaulted comparisons, ranges, std::span,
  std::format, the smaller features, and the C++20 features not used.
- Cpp17/LANGUAGE.md holds what a C++17 project does instead: building
  with -std=c++17, the C++17 form of each C++20 rule (the former
  section 5.13) and the checks a C++17 library needs for later
  standards.
- index.json lists every document with its chapter, its path and the
  versions it applies to, and names the default version.

No rule changed. The README lists the version pages and the layout,
ADOPTING.md points to the page of the chosen version, and the changelog
says where Guide/ went. Every relative link and heading anchor was
checked.

Co-Authored-By: Claude Opus 5.5 &lt;noreply@anthropic.com&gt;
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
The guide moves to Progmasoft_Core_Cpp_Coding_Guidelines/:

- Common/ holds the thirteen chapters, which apply to C++17 and C++20
  alike. Where a chapter used a C++20 feature, it now states the rule
  for both versions and links to the page of each.
- Cpp20/LANGUAGE.md holds the rules that use C++20 features: building
  with -std=c++20, designated initializers, consteval and constinit,
  std::bit_cast, concepts, defaulted comparisons, ranges, std::span,
  std::format, the smaller features, and the C++20 features not used.
- Cpp17/LANGUAGE.md holds what a C++17 project does instead: building
  with -std=c++17, the C++17 form of each C++20 rule (the former
  section 5.13) and the checks a C++17 library needs for later
  standards.
- index.json lists every document with its chapter, its path and the
  versions it applies to, and names the default version.

No rule changed. The README lists the version pages and the layout,
ADOPTING.md points to the page of the chosen version, and the changelog
says where Guide/ went. Every relative link and heading anchor was
checked.

Co-Authored-By: Claude Opus 5.5 &lt;noreply@anthropic.com&gt;
</pre>
</div>
</content>
</entry>
</feed>
