mirror of
https://github.com/google/styleguide.git
synced 2024-03-22 13:11:43 +08:00
Merge pull request #1 from cgarciaromaguera/cgarciaromaguera-documentation
Update README.md
This commit is contained in:
commit
9481092a51
23
README.md
23
README.md
|
@ -1,4 +1,6 @@
|
||||||
# Google Style Guides
|
# Google Style Guides
|
||||||
|
# Ad logo if applicable
|
||||||
|
// if headers are added, recommend using a table of contents
|
||||||
|
|
||||||
Every major open-source project has its own style guide: a set of conventions
|
Every major open-source project has its own style guide: a set of conventions
|
||||||
(sometimes arbitrary) about how to write code for that project. It is much
|
(sometimes arbitrary) about how to write code for that project. It is much
|
||||||
|
@ -12,6 +14,11 @@ guidelines we use for Google code. If you are modifying a project that
|
||||||
originated at Google, you may be pointed to this page to see the style guides
|
originated at Google, you may be pointed to this page to see the style guides
|
||||||
that apply to that project.
|
that apply to that project.
|
||||||
|
|
||||||
|
# How to use the Project
|
||||||
|
//include how to change Google originated projects to intended style guide
|
||||||
|
// how to change style guides on Google
|
||||||
|
|
||||||
|
# Style Guides
|
||||||
|
|
||||||
* [AngularJS Style Guide][angular]
|
* [AngularJS Style Guide][angular]
|
||||||
* [Common Lisp Style Guide][cl]
|
* [Common Lisp Style Guide][cl]
|
||||||
|
@ -33,12 +40,21 @@ This project also contains [cpplint][cpplint], a tool to assist with style guide
|
||||||
compliance, and [google-c-style.el][emacs], an Emacs settings file for Google
|
compliance, and [google-c-style.el][emacs], an Emacs settings file for Google
|
||||||
style.
|
style.
|
||||||
|
|
||||||
|
# Installation/Run Process
|
||||||
|
|
||||||
|
// Add installation process
|
||||||
|
// Recommend description of installation process for different devices
|
||||||
|
|
||||||
|
# Additional Formats
|
||||||
|
|
||||||
If your project requires that you create a new XML document format, the
|
If your project requires that you create a new XML document format, the
|
||||||
[XML Document Format Style Guide][xml] may be helpful. In addition to actual
|
[XML Document Format Style Guide][xml] may be helpful. In addition to actual
|
||||||
style rules, it also contains advice on designing your own vs. adapting an
|
style rules, it also contains advice on designing your own vs. adapting an
|
||||||
existing format, on XML instance document formatting, and on elements vs.
|
existing format, on XML instance document formatting, and on elements vs.
|
||||||
attributes.
|
attributes.
|
||||||
|
|
||||||
|
# License
|
||||||
|
|
||||||
The style guides in this project are licensed under the CC-By 3.0 License, which
|
The style guides in this project are licensed under the CC-By 3.0 License, which
|
||||||
encourages you to share these documents. See
|
encourages you to share these documents. See
|
||||||
[https://creativecommons.org/licenses/by/3.0/][ccl] for more details.
|
[https://creativecommons.org/licenses/by/3.0/][ccl] for more details.
|
||||||
|
@ -79,3 +95,10 @@ changes, but we are primarily optimizing for Google's internal needs.
|
||||||
[xml]: https://google.github.io/styleguide/xmlstyle.html
|
[xml]: https://google.github.io/styleguide/xmlstyle.html
|
||||||
[dart]: https://www.dartlang.org/guides/language/effective-dart
|
[dart]: https://www.dartlang.org/guides/language/effective-dart
|
||||||
[ccl]: https://creativecommons.org/licenses/by/3.0/
|
[ccl]: https://creativecommons.org/licenses/by/3.0/
|
||||||
|
|
||||||
|
# Badges
|
||||||
|
//include project badges
|
||||||
|
//inform developers on what they are doing
|
||||||
|
|
||||||
|
# Test
|
||||||
|
//include tests to see how style guides are implemented
|
||||||
|
|
Loading…
Reference in New Issue
Block a user