Edits for gh-pages

This commit is contained in:
Andrew Pardoe
2015-12-12 17:04:13 -08:00
parent b0ea200a06
commit 3822565574
3 changed files with 96 additions and 4 deletions

86
CONTRIBUTING.md Normal file
View File

@@ -0,0 +1,86 @@
## Contributing to the C++ Core Guidelines
>"Within C++ is a smaller, simpler, safer language struggling to get out."
>-- <cite>Bjarne Stroustrup</cite>
The C++ Core Guidelines are a collaborative effort led by Bjarne Stroustrup, much like the C++ language itself. They are the result of many
person-years of discussion and design across a number of organizations. Their design encourages general applicability and broad adoption but
they can be freely copied and modified to meet your organization's needs.
We encourage contributions to the C++ Core Guidelines in a number of ways:
- **Individual feedback** Are you a developer who is passionate about your code? Join the discussion in
[Issues](https://github.com/isocpp/CppCoreGuidelines/issues). We want to know which rules resonate with you and which don't. Were any rules
inordinately difficult to apply? Does your compiler vendor's Guideline Support Library (e.g.,
[Microsoft's implementation of the GSL](https://github.com/microsoft/gsl)) suit your needs in adopting these guidelines?
- **Organizational adoption** While the guidelines are designed to be broadly adoptable they are also intended to be modified to fit your
organization's particular needs. We encourage your organization to fork this repo and create your own copy of these guidelines with changes
that reflect your needs. We suggest that you make it clear in the title of your guidelines that these are your organization's fork of the
guidelines and that you provide a link back to the original set of [guidelines](https://github.com/isocpp/CppCoreGuidelines). And if any of
your local changes are appropriate to pull back into the original guidelines, please open an
[Issue](https://github.com/isocpp/CppCoreGuidelines/issues) which can lead to a pull request.
- **Maintain the Guidelines** The C++ Core Guidelines were created from a wealth of knowledge spread across a number of organizations
worldwide. If you or your organization is passionate about helping to create the guidelines consider becoming an editor or maintainer. If
you're a C++ expert who is serious about participating please
[email coreguidelines@isocpp.org](mailto:coreguidelines@isocpp.org?subject=Maintain the C++ Code Guidelines).
## Contributor License Agreement
By contributing content to the C++ Core Guidelines (i.e., submitting a pull request for inclusion in this repository) you agree with the
[Standard C++ Foundation](https://isocpp.org/about) [Terms of Use](https://isocpp.org/home/terms-of-use), especially all of the terms specified
regarding Copyright and Patents.
- You warrant that your material is original, or you have the right to contribute it.
- With respect to the material that you own, you grant a worldwide non-exclusive irrevocable transferable royalty-free license to your contributed
material to Standard C++ Foundation to display, reproduce, perform, distribute and create derivative works of that material for commercial or
non-commercial use. With respect to any other material you contribute, such material must be under a license sufficient to allow Standard C++ Foundation
to display, reproduce, perform, distribute and create derivative works of that material for commercial or non-commercial use.
- You agree that, if your contributed material is subsequently reflected in the ISO/IEC C++ standard in any form, it will be subject to all ISO/IEC JTC
1 policies including [copyrights](http://www.iso.org/iso/home/policies.htm),
[patents](http://www.iso.org/iso/home/standards_development/governance_of_technical_work/patents.htm), and
[procedures](http://www.itscj.ipsj.or.jp/sc29/29w7proc.htm); please direct any questions about these policies to the
[ISO Central Secretariat](http://www.iso.org/iso/home/about.htm).
## Pull requests
We welcome pull requests for scoped changes to the guidelines--bug fixes in
examples, clarifying ambiguous text, etc. Significant changes should first be
discussed in the [Issues](https://github.com/isocpp/CppCoreGuidelines/issues)
and the Issue number must be included in the pull request. For
guideline-related changes, please specify the rule number in your Issue and/or
Pull Request.
Changes should be made in a child commit of a recent commit in the master
branch. If you are making many small changes, please create separate PRs to
minimize merge issues.
### Document Style Guidelines
Documents in this repository are written in an unspecific flavor of Markdown,
which leaves some ambiguity for formatting text. We ask that pull requests
maintain the following style guidelines, though we are aware that the document
may not already be consistent.
#### Indentation
Code and nested text should use multiples of 4 spaces of indentation, and no
tab characters, like so:
void func(const int x)
{
std::cout << x << '\n';
}
#### Code Blocks
Please use 4-space indentation to trigger code parsing, rather than [fenced code blocks](https://help.github.com/articles/github-flavored-markdown/#fenced-code-blocks) or any other style, like so:
This is some document text, with an example below:
void func()
{
std::cout << "This is code.\n";
}
### Miscellaneous
To avoid line-ending issues, please set `autocrlf = input` and `whitespace =
cr-at-eol` in your git configuration.

View File

@@ -19,9 +19,10 @@
<a class="sidebar-nav-item active" href="#S-functions">F: Functions</a> <a class="sidebar-nav-item active" href="#S-functions">F: Functions</a>
<a class="sidebar-nav-item active" href="#S-class">C: Classes and class hierarchies</a> <a class="sidebar-nav-item active" href="#S-class">C: Classes and class hierarchies</a>
<a class="sidebar-nav-item active" href="#S-enum">Enum: Enumerations</a> <a class="sidebar-nav-item active" href="#S-enum">Enum: Enumerations</a>
<a class="sidebar-nav-item active" href="#S-resource">R: Resource management</a>
<a class="sidebar-nav-item active" href="#S-expr">ES: Expressions and statements</a> <a class="sidebar-nav-item active" href="#S-expr">ES: Expressions and statements</a>
<a class="sidebar-nav-item active" href="#S-errors">E: Error handling</a> <a class="sidebar-nav-item active" href="#S-errors">E: Error handling</a>
<a class="sidebar-nav-item active" href="#S-resource">R: Resource management</a> <a class="sidebar-nav-item active" href="#S-const">Con: Constants and immutability</a>
<a class="sidebar-nav-item active" href="#S-templates">T: Templates and generic programming</a> <a class="sidebar-nav-item active" href="#S-templates">T: Templates and generic programming</a>
<a class="sidebar-nav-item active" href="#S-concurrency">CP: Concurrency</a> <a class="sidebar-nav-item active" href="#S-concurrency">CP: Concurrency</a>
<a class="sidebar-nav-item active" href="#S-stdlib">STL: The Standard library</a> <a class="sidebar-nav-item active" href="#S-stdlib">STL: The Standard library</a>
@@ -29,6 +30,7 @@
<a class="sidebar-nav-item active" href="#S-cpl">CPL: C-style programming</a> <a class="sidebar-nav-item active" href="#S-cpl">CPL: C-style programming</a>
<a class="sidebar-nav-item active" href="#S-profile">PRO: Profiles</a> <a class="sidebar-nav-item active" href="#S-profile">PRO: Profiles</a>
<a class="sidebar-nav-item active" href="#S-gsl">GSL: Guideline support library</a> <a class="sidebar-nav-item active" href="#S-gsl">GSL: Guideline support library</a>
<a class="sidebar-nav-item active" href="#S-faw">FAQ: Answers to frequently asked questions</a>
<a class="sidebar-nav-item active" href="#S-naming">NL: Naming and layout</a> <a class="sidebar-nav-item active" href="#S-naming">NL: Naming and layout</a>
<a class="sidebar-nav-item active" href="#S-performance">PER: Performance</a> <a class="sidebar-nav-item active" href="#S-performance">PER: Performance</a>
@@ -37,12 +39,13 @@
<a class="sidebar-nav-item active" href="#S-libraries">Appendix A: Libraries</a> <a class="sidebar-nav-item active" href="#S-libraries">Appendix A: Libraries</a>
<a class="sidebar-nav-item active" href="#S-modernizing">Appendix B: Modernizing code</a> <a class="sidebar-nav-item active" href="#S-modernizing">Appendix B: Modernizing code</a>
<a class="sidebar-nav-item active" href="#S-discussion">Appendix C: Discussion</a> <a class="sidebar-nav-item active" href="#S-discussion">Appendix C: Discussion</a>
<a class="sidebar-nav-item active" href="#S-glossary">Appendix C: Glossary</a>
<a class="sidebar-nav-item active" href="#S-unclassified">To-do: Unclassified proto-rules</a> <a class="sidebar-nav-item active" href="#S-unclassified">To-do: Unclassified proto-rules</a>
<button id="button">Highlighting</button> <button id="button">Highlighting</button>
{% else %} {% else %}
<a class="sidebar-nav-item active" href="CppCoreGuidelines.html">The actual Guidelines</a> <a class="sidebar-nav-item active" href="CppCoreGuidelines.html">C++ Core Guidelines</a>
<a class="sidebar-nav-item active" href="index.html">README</a> <a class="sidebar-nav-item active" href="index.html">README</a>
<a class="sidebar-nav-item active" href="CONTRIBUTING.html">Contributing</a> <a class="sidebar-nav-item active" href="CONTRIBUTING.html">Contributing</a>
<a class="sidebar-nav-item active" href="LICENSE">License</a> <a class="sidebar-nav-item active" href="LICENSE">License</a>

View File

@@ -2,16 +2,19 @@
layout: default layout: default
--- ---
<p class="sidebar-about">This site is clone of the C++ Core Guidelines demonstrating the possible use of github pages. The source files from the master branch are not changed (with the exception of 3 lines added at the top). This site shows how stylesheets, a sidebar and syntax highlighting could be added for better readability (button at bottom of sidebar). Prettier fonts can be used (than github default), and the code-blocks have been adapted not to wrap long lines on large screens. <p class="sidebar-about">This site is copy of the C++ Core Guidelines rendered for easier browsing. As the text on this page is integrated manually
you should refer to the <a href="https://github.com/isocpp/CppCoreGuidelines">C++ Core Guidelines repo</a> for the most up-to-date version.
</p> </p>
<!-- HEADER --> <!-- HEADER -->
<div id="header_wrap" class="outer"> <div id="header_wrap" class="outer">
<header class="inner"> <header class="inner">
<!--
<section id="downloads"> <section id="downloads">
<a class="zip_download_link" href="https://github.com/tkruse/CppCoreGuidelines/zipball/master">Download this project as a .zip file</a> <a class="zip_download_link" href="https://github.com/tkruse/CppCoreGuidelines/zipball/master">Download this project as a .zip file</a>
<a class="tar_download_link" href="https://github.com/tkruse/CppCoreGuidelines/tarball/master">Download this project as a tar.gz file</a> <a class="tar_download_link" href="https://github.com/tkruse/CppCoreGuidelines/tarball/master">Download this project as a tar.gz file</a>
</section> </section>
-->
</header> </header>
</div> </div>