From c1c7a96378d79d379e68084780eecd91731fa4bb Mon Sep 17 00:00:00 2001 From: Himanshu81494 Date: Fri, 9 Oct 2015 19:57:06 +0530 Subject: typo in readme --- README.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'README.markdown') diff --git a/README.markdown b/README.markdown index 774797d5..28fa5093 100644 --- a/README.markdown +++ b/README.markdown @@ -8,7 +8,7 @@ commented code and explained as they go. ... to write more inline code tutorials. Just grab an existing file from this repo and copy the formatting (don't worry, it's all very simple). -Make a new file, send a pull request, and if it passes muster I'll get it up pronto. +Make a new file, send a pull request, and if it passes master I'll get it up pronto. Remember to fill in the "contributors" fields so you get credited properly! -- cgit v1.2.3 From 55bcb104c0ef2f28339a045d9556b544a6f491e6 Mon Sep 17 00:00:00 2001 From: Maxfield Lehman Date: Sat, 17 Oct 2015 02:46:14 -0700 Subject: Fix typo in README - "passes master" -> "passes muster" --- README.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'README.markdown') diff --git a/README.markdown b/README.markdown index 28fa5093..774797d5 100644 --- a/README.markdown +++ b/README.markdown @@ -8,7 +8,7 @@ commented code and explained as they go. ... to write more inline code tutorials. Just grab an existing file from this repo and copy the formatting (don't worry, it's all very simple). -Make a new file, send a pull request, and if it passes master I'll get it up pronto. +Make a new file, send a pull request, and if it passes muster I'll get it up pronto. Remember to fill in the "contributors" fields so you get credited properly! -- cgit v1.2.3 From 600483a4582713b515e1e72fd842927bbb30a613 Mon Sep 17 00:00:00 2001 From: Santhosh Kumar Srinivasan Date: Sat, 17 Oct 2015 19:38:39 +0530 Subject: Fix typo on readme Just a typo. Changed `tag your issues pull requests with` to `tag your issues and pull requests with` --- README.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'README.markdown') diff --git a/README.markdown b/README.markdown index 28fa5093..46408a04 100644 --- a/README.markdown +++ b/README.markdown @@ -18,7 +18,7 @@ All contributions are welcome, from the tiniest typo to a brand new article. Tra in all languages are welcome (or, for that matter, original articles in any language). Send a pull request or open an issue any time of day or night. -**Please tag your issues pull requests with [language/lang-code] at the beginning** +**Please tag your issues and pull requests with [language/lang-code] at the beginning** **(e.g. [python/en] for English Python).** This will help everyone pick out things they care about. -- cgit v1.2.3 From cffb7e6770b517a620115b3a9e1f82ca1dd82a98 Mon Sep 17 00:00:00 2001 From: Hunter Stevens Date: Fri, 23 Oct 2015 14:25:42 -0400 Subject: Add contributing-specific file --- README.markdown | 64 +++++++++------------------------------------------------ 1 file changed, 10 insertions(+), 54 deletions(-) (limited to 'README.markdown') diff --git a/README.markdown b/README.markdown index 94afbcbe..1360732b 100644 --- a/README.markdown +++ b/README.markdown @@ -1,4 +1,4 @@ -# [Learn X in Y minutes](http://learnxinyminutes.com) +# [Learn X in Y minutes][1] Whirlwind tours of (several, hopefully many someday) popular and ought-to-be-more-popular programming languages, presented as valid, @@ -18,71 +18,27 @@ All contributions are welcome, from the tiniest typo to a brand new article. Tra in all languages are welcome (or, for that matter, original articles in any language). Send a pull request or open an issue any time of day or night. -**Please tag your issues and pull requests with [language/lang-code] at the beginning** -**(e.g. [python/en] for English Python).** This will help everyone pick out things they -care about. +**Please prepend the tag `[language/lang-code]` to your issues and pull requests.** For example, +`[python/en]` for English Python. This will help everyone pick out things they care about. We're happy for any contribution in any form, but if you're making more than one major change (i.e. translations for two different languages) it would be super cool of you to make a separate pull request for each one so that someone can review them more effectively and/or individually. -### Style Guidelines - -* **Keep lines under 80 chars** -* **Prefer example to exposition** -* **Eschew surplusage** -* **Use UTF-8** - -Long version: - -* Try to keep **line length in code blocks to 80 characters or fewer**, or they'll overflow - and look odd. - -* Try to use as few words as possible. Code examples are preferred over exposition in all cases. - -* We welcome newcomers, but the target audience for this site is programmers with some experience. - So, try to avoid explaining basic concepts except for those specific to the language in question, - to keep articles succinct and scannable. We all know how to use Google here. - -* For translations (or English articles with non-ASCII characters), please make sure your file is - UTF-8 encoded, and try to leave out the byte-order-mark at the start of the file. (`:set nobomb` in Vim) - -### Header configuration - -The actual site uses Middleman to generate HTML files from these Markdown ones. Middleman, or at least -the custom scripts underpinning the site, required that some key information be defined in the header. - -The following fields are necessary for English articles about programming languages: - -* **language** The *programming language* in question -* **contributors** A list of [author, URL] lists to credit - -Other fields: - -* **filename**: The filename for this article's code. It will be fetched, mashed together, and made downloadable. - For non-English articles, *filename* should have a language-specific suffix. -* **lang**: For translations, the human language this article is in. For categorization, mostly. - -Here's an example header for an Esperanto translation of Ruby: - -```yaml ---- -language: ruby -filename: learnruby-epo.ruby -contributors: - - ["Doktor Esperanto", "http://example.com/"] - - ["Someone else", "http://someoneelseswebsite.com/"] -lang: ep-ep ---- -``` +For a detailed style guide, please review the full [CONTRIBUTING][2] guidelines. ## License Contributors retain copyright to their work, and can request removal at any time. By uploading a doc here, you agree to publish your work under the default -[Creative Commons Attribution-ShareAlike 3.0 Unported](http://creativecommons.org/licenses/by-sa/3.0/deed.en_US) +[Creative Commons Attribution-ShareAlike 3.0 Unported][3] licensing included on each doc page. Anything not covered by the above -- basically, this README -- you can use as you wish, I guess. + + +[1]: http://learnxinyminutes.com +[2]: https://github.com/adambard/learnxinyminutes-docs/blob/master/CONTRIBUTING.markdown +[3]: http://creativecommons.org/licenses/by-sa/3.0/deed.en_US -- cgit v1.2.3 From 4b0dda63b31873fad1b038c1db4745aaa20756cf Mon Sep 17 00:00:00 2001 From: Zane Sterling Date: Sun, 25 Oct 2015 12:55:50 -0400 Subject: Fix typo in README.md --- README.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'README.markdown') diff --git a/README.markdown b/README.markdown index 94afbcbe..092785f8 100644 --- a/README.markdown +++ b/README.markdown @@ -51,7 +51,7 @@ Long version: ### Header configuration The actual site uses Middleman to generate HTML files from these Markdown ones. Middleman, or at least -the custom scripts underpinning the site, required that some key information be defined in the header. +the custom scripts underpinning the site, requires that some key information be defined in the header. The following fields are necessary for English articles about programming languages: -- cgit v1.2.3 From 36f46947b8f483146840f0d011427cdb8174860d Mon Sep 17 00:00:00 2001 From: Adam Bard Date: Wed, 9 Nov 2016 21:52:07 -0800 Subject: Update README.markdown --- README.markdown | 2 ++ 1 file changed, 2 insertions(+) (limited to 'README.markdown') diff --git a/README.markdown b/README.markdown index a71e85bd..9ea9b85d 100644 --- a/README.markdown +++ b/README.markdown @@ -1,5 +1,7 @@ # [Learn X in Y minutes][1] +https://travis-ci.org/adambard/learnxinyminutes-docs.svg?branch=master + Whirlwind tours of (several, hopefully many someday) popular and ought-to-be-more-popular programming languages, presented as valid, commented code and explained as they go. -- cgit v1.2.3 From 1d494a6346aa3422b086cbfa85fc62c917516a8b Mon Sep 17 00:00:00 2001 From: Adam Bard Date: Wed, 9 Nov 2016 21:52:17 -0800 Subject: Update README.markdown --- README.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'README.markdown') diff --git a/README.markdown b/README.markdown index 9ea9b85d..a02a89cb 100644 --- a/README.markdown +++ b/README.markdown @@ -1,6 +1,6 @@ # [Learn X in Y minutes][1] -https://travis-ci.org/adambard/learnxinyminutes-docs.svg?branch=master +![](https://travis-ci.org/adambard/learnxinyminutes-docs.svg?branch=master) Whirlwind tours of (several, hopefully many someday) popular and ought-to-be-more-popular programming languages, presented as valid, commented -- cgit v1.2.3 From d55180ff11a3e74127172fc7588d606a42b56cfd Mon Sep 17 00:00:00 2001 From: Samantha McVey Date: Wed, 9 Nov 2016 22:30:41 -0800 Subject: Make build status a link --- README.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'README.markdown') diff --git a/README.markdown b/README.markdown index a02a89cb..bc93f5d2 100644 --- a/README.markdown +++ b/README.markdown @@ -1,6 +1,6 @@ # [Learn X in Y minutes][1] -![](https://travis-ci.org/adambard/learnxinyminutes-docs.svg?branch=master) +[![Build Status](https://travis-ci.org/adambard/learnxinyminutes-docs.svg?branch=master](https://travis-ci.org/adambard/learnxinyminutes-docs) Whirlwind tours of (several, hopefully many someday) popular and ought-to-be-more-popular programming languages, presented as valid, commented -- cgit v1.2.3 From f53e89f7cb318b89c6b05ffd7e1c7471f817a3b1 Mon Sep 17 00:00:00 2001 From: Samantha McVey Date: Wed, 9 Nov 2016 22:31:46 -0800 Subject: Fix missing parenthesis --- README.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'README.markdown') diff --git a/README.markdown b/README.markdown index bc93f5d2..9a8a3752 100644 --- a/README.markdown +++ b/README.markdown @@ -1,6 +1,6 @@ # [Learn X in Y minutes][1] -[![Build Status](https://travis-ci.org/adambard/learnxinyminutes-docs.svg?branch=master](https://travis-ci.org/adambard/learnxinyminutes-docs) +[![Build Status](https://travis-ci.org/adambard/learnxinyminutes-docs.svg?branch=master)](https://travis-ci.org/adambard/learnxinyminutes-docs) Whirlwind tours of (several, hopefully many someday) popular and ought-to-be-more-popular programming languages, presented as valid, commented -- cgit v1.2.3