Code documentation written as code! How novel and totally my idea!
Go to file
samcv e336c909b9 Perl 6: Make information about Hash tables correct. Rewrite the example for dynamically scoped variables.. (#2475)
* Explain that you cannot pass immutable values like integers to subs even if you use $n is rw.

* Add myself as a contributor

* Remove contributor since I am not a major contributor

* Add many more smartmatch examples. Make the ternary operatory clearer and add a code example for it. Make the section for && and || have a working code example and show the output it gives

* Fix assigning $a $b and $c values in the && operator section

* Rename a few things so they don't conflict with variables in other parts of the code

* Remove extra dashes

* Move description of smartmatch type checks toward the end of that section

* Better names for scoping examples

* Redo the example for dynamically scoped variables so the example is better and functions properly when ran (old example did not work properly when running it by itself)

* Rename these classes so they aren't named the same as the ones above

* Add information about the different twigils in Perl 6. This makes understanding what $. $! and $* are and how they relate. Also complete the renaming in the previous commit

* Fix capitalization and indenting here

* Using the word interpolate to mean accessing an element of an array is not the proper terminology. Using the word interpolate is usually associated with things such as this: say "@names = { @names.perl }"

* Make the wording a little clearer for arrays

* Remove incorrect information about hashes.  Hashes are not arrays of pairs although Perl 6 makes it easy to use them as such

* Make the subroutine text read better

* Clean up the Object Model introduction section

* Fix the section on interpolating all elements of an array

* Use the word attribute instead of field since this is the wording that the perl 6 documentation uses for these objects

* Fix column width in a few places

* More clearly mark which twigils are used for "normal" variables and which ones are used on "objects". This makes the flow from the # Scoping => # Twigil => # Object Model section smoother

* Semi-rewrite the example for object inheritance and use more natural names.  Also rename class A to class Attrib-Class

* Clean up the scoping introduction a little

* Remove a leftover line from rewriting the inheritance example

* More gradually introduce exceptions and fix a typo, as well as adding a few examples

* Reorder introduction of packages to be more natural. Show how to "use" a package before we show how to create and declare our own modules

* Avoid using the word 'use' because we're not refering to the perl keyword 'use'
2016-10-20 15:59:55 +02:00
bg-bg Create bg-bg/perl.html.markdown (#2255) 2016-05-13 21:12:19 +02:00
cs-cz Update go.html.markdown 2016-09-05 22:19:48 +02:00
de-de [html/de] Translate html to german (#2440) 2016-10-15 22:10:00 +02:00
el-gr Update css-gr.html.markdown (#2263) 2016-05-19 16:16:11 +02:00
es-es Move Spanish SASS tutorial to the ES folder (#2468) 2016-10-17 08:40:31 +02:00
fa-ir fix fa-ir/css 2016-03-13 10:50:39 +01:00
fi-fi Fix capitalization of GitHub 2016-02-23 16:12:44 -08:00
fr-fr Add as-> macro documentation (#2392) 2016-10-02 13:55:49 +02:00
hd-hd Metadata fixups for #1673 2016-06-26 14:33:01 +02:00
hu-hu metadata fixup for #1874 2016-06-26 14:51:54 +02:00
id-id [coffeescript/id] Create coffeescript-id.html.markdown (#2400) 2016-10-03 15:40:25 +02:00
it-it Bring this version up to date with the english one (#2401) 2016-10-03 22:14:30 +02:00
ja-jp [bash-jp/ja-jp] Corrected spelling. seperated -> separated 2016-02-17 22:23:30 -07:00
ko-kr adds Korean translation for Erlang 2016-02-28 15:28:44 -08:00
lt-lt Update json-lt.html.markdown 2016-03-21 16:32:07 -07:00
ms-my Merge pull request #1691 from hack1m/sass-my-translation 2016-03-13 10:51:32 +01:00
nl-nl Remove redundant nl markdown and fix fortran file 2016-08-31 15:18:38 -07:00
no-nb fixup for #1532 2016-08-24 09:00:23 +02:00
pl-pl fix #2382 2016-09-22 16:25:13 +02:00
pt-br [vim/pt_br] Translate vim to portuguese (#2474) 2016-10-18 21:38:53 +02:00
pt-pt Update Swift pre-decrement syntax to match v3.0 (#2395) 2016-10-01 22:33:04 +02:00
ro-ro Attempt at #2299 2016-07-06 12:09:20 +02:00
ru-ru [swift/ru] Updated code to Swift v.3, added some new sections from english version (#2429) 2016-10-08 22:29:13 +02:00
sk-sk Delete LearnGit-sk.txt 2016-10-18 22:36:03 +02:00
sv-se [json/sv-se] Synced with english version. (#2324) 2016-08-04 09:10:00 +02:00
ta_in Clean up various errors 2016-02-12 23:04:31 -08:00
tr-tr Remove redundant nl markdown and fix fortran file 2016-08-31 15:18:38 -07:00
uk-ua [json/uk-ua] translation improvement (#2461) 2016-10-15 17:29:43 +02:00
vi-vn Update objective-c-vi.html.markdown 2016-03-15 15:35:51 -07:00
zh-cn Update Swift pre-decrement syntax to match v3.0 (#2395) 2016-10-01 22:33:04 +02:00
zh-tw [bash/zh-tw] delete extra line 2016-08-03 02:05:09 +08:00
.gitignore Updated, referencing #2185 2016-03-14 12:38:47 +05:30
amd.html.markdown removing whitespace all over 2015-10-07 23:11:24 -04:00
asciidoc.html.markdown [asciidoc/en] fixed a couple of typos 2016-02-17 06:36:47 -07:00
asymptotic-notation.html.markdown Fixed typos and content exceeding beyond 80 chars 2016-03-12 16:58:00 +05:30
bash.html.markdown Removed excessive dollar signs (#2447) 2016-10-13 08:25:44 +02:00
bf.html.markdown brainfuck->bf 2016-02-12 11:42:25 -08:00
binary-search.html.markdown Add missing space. (#2356) 2016-09-05 09:42:02 +02:00
c.html.markdown Update c.html.markdown (#2385) 2016-09-27 21:55:01 +02:00
c++.html.markdown Some minor (mostly stylistic) fixes in C++ 2016-08-02 16:32:38 +03:00
chapel.html.markdown Fix capitalization of GitHub 2016-02-23 16:12:44 -08:00
CHICKEN.html.markdown adding CHICKEN (#2379) 2016-09-19 19:41:28 +02:00
clojure-macros.html.markdown removing whitespace all over 2015-10-07 23:11:24 -04:00
clojure.html.markdown Add as-> macro documentation (#2392) 2016-10-02 13:55:49 +02:00
cmake.html.markdown minor typo (#2349) 2016-08-30 10:11:09 +02:00
coffeescript.html.markdown Merge pull request #1424 from AndyBrown91/coffeescript 2015-10-09 20:00:54 +02:00
coldfusion.html.markdown replaced < and > in pre block 2015-12-18 09:35:15 -06:00
common-lisp.html.markdown [common-lisp/en] Fix code in examples 2015-12-09 00:03:06 +03:00
compojure.html.markdown Use keywords in POST/PUT examples 2015-05-30 11:43:37 -06:00
CONTRIBUTING.markdown Resolve conflicts from merge 2016-02-15 17:47:35 -05:00
csharp.html.markdown Csharp parallel (#2443) 2016-10-11 09:33:17 +02:00
css.html.markdown Address @geoffliu's comment in #1637 2016-09-06 10:31:03 +02:00
d.html.markdown fix parallelism example typo 2016-01-02 18:43:19 +02:00
dart.html.markdown Update dart.html.markdown 2015-10-31 22:16:39 +01:00
dynamic-programming.html.markdown Update syntax (#2455) 2016-10-15 13:11:23 +02:00
edn.html.markdown Clean up various errors 2016-02-12 23:04:31 -08:00
elisp.html.markdown [elisp/en] Fix tiny typo (#2327) 2016-08-07 23:21:54 +02:00
elixir.html.markdown [elixir/en] Adds elixir documentation on the pipe operator. (#2434) 2016-10-09 13:28:23 +02:00
elm.html.markdown Add file to download and correct the language used in Markdown code block (#2368) 2016-09-13 18:28:53 +02:00
erlang.html.markdown Replaced 'or' with a semicolons 2015-11-19 15:51:08 +03:00
factor.html.markdown [factor/en] minor typo. dont -> don't 2016-03-05 17:57:08 -07:00
file.erb Added filename parameter 2013-06-29 20:19:14 -07:00
forth.html.markdown [forth/en] don't -> don't 2016-03-14 10:26:18 -06:00
fortran95.html.markdown Remove redundant nl markdown and fix fortran file 2016-08-31 15:18:38 -07:00
fsharp.html.markdown [fsharp/en] Explain the cons pattern, and introduce recursion keyword (#2310) 2016-08-04 14:41:16 +02:00
git.html.markdown Add very cool interactive tutorial (#2375) 2016-09-16 12:25:41 +02:00
go.html.markdown Updated closure 2016-06-04 00:26:18 -07:00
groovy.html.markdown [groovy/es] Groovy translated to Spanish (#1791) 2016-05-27 11:30:17 +02:00
hack.html.markdown removing whitespace all over 2015-10-07 23:11:24 -04:00
haml.html.markdown Merge pull request #1438 from chashmeetsingh/patch-8 2015-10-12 23:07:44 -05:00
haskell.html.markdown Merge pull request #1758 from patrikja/patch-2 2016-02-11 16:54:21 +01:00
haxe.html.markdown [haxe/en] Adding colon after comments 2015-05-20 14:29:05 +02:00
html.html.markdown [html/en] few changes to the file (#2406) 2016-10-03 15:41:42 +02:00
hy.html.markdown Merge pull request #1574 from Zirak/patch-1 2016-03-11 09:35:04 +01:00
inform7.html.markdown Add a try at an Inform 7 tutorial. 2016-01-22 00:54:44 +00:00
java.html.markdown Added try-with-resources to Java docs (#2438) 2016-10-10 12:43:12 +02:00
javascript.html.markdown Added new resource to javascript 2015-10-31 16:49:57 -07:00
jquery.html.markdown fixup 2016-09-06 10:29:48 +02:00
json.html.markdown [json/en] Cut noise, formatting, links. 2015-10-20 14:24:32 +05:30
julia.html.markdown Update Dict and Set Syntax (#2296) 2016-07-02 16:02:38 +02:00
kotlin.html.markdown Several changes on Kontlin. (#2335) 2016-10-12 11:47:41 +02:00
latex.html.markdown Add Hyperlinks description (#2370) 2016-09-27 16:41:45 +02:00
less.html.markdown Fix typos and improve styles (#2460) 2016-10-15 16:22:02 +02:00
livescript.html.markdown removing whitespace all over 2015-10-07 23:11:24 -04:00
logtalk.html.markdown Fixes and improvements to the Logtalk tutorial (#2470) 2016-10-18 17:15:43 +02:00
lua.html.markdown Fix typo (#2317) 2016-07-30 18:28:27 +02:00
make.html.markdown Merge pull request #2167 from divayprakash/typos-fix 2016-03-12 09:31:02 +01:00
markdown.html.markdown Fixed "<br />" example tag by showing it as code (#2411) 2016-10-04 15:41:21 +02:00
matlab.html.markdown Add a section on code sections/cells (#1855) 2016-06-26 14:45:45 +02:00
meteor.html.markdown Update meteor.html.markdown 2016-09-06 10:28:47 +02:00
neat.html.markdown removing whitespace all over 2015-10-07 23:11:24 -04:00
nim.html.markdown [nim/en] Correct syntax highlighting 2016-03-23 13:50:24 -05:00
nix.html.markdown Remove nix highlighting (we don't have it) 2016-05-19 11:11:39 -07:00
objective-c.html.markdown fix #2308 2016-07-12 19:14:38 +02:00
ocaml.html.markdown Change anonymous function in List.filter example 2016-03-26 12:27:56 +00:00
paren.html.markdown Updating header with contribution name 2015-10-20 11:40:45 -03:00
pcre.html.markdown Add an example of trap command (#1826) 2016-06-26 14:38:05 +02:00
perl6.html.markdown Perl 6: Make information about Hash tables correct. Rewrite the example for dynamically scoped variables.. (#2475) 2016-10-20 15:59:55 +02:00
perl.html.markdown [perl/en] Fix line formatting and use $x instead of $a 2016-04-15 03:23:10 -04:00
pets.csv Create pets.csv 2013-06-29 03:38:34 -04:00
php-composer.html.markdown [php-composer/en] Add new tool document for Composer, PHP's dependency manager. 2015-10-20 12:46:58 +13:00
php.html.markdown Change curly braces statement (#1804) 2016-06-16 15:04:40 +02:00
pogo.html.markdown Fixed typo at the end 2014-12-22 13:26:30 +01:00
powershell.html.markdown [PowerShell/en]: fixed typos/layout. Added some extra aliases/info. 2016-01-08 19:52:33 +01:00
PULL_REQUEST_TEMPLATE.md YESSSSS! 2016-02-17 21:59:45 -08:00
purescript.html.markdown [purescript/en] comparisions -> comparisons 2016-02-27 15:38:22 -07:00
pyqt.html.markdown useless "lang: en" (#2462) 2016-10-15 22:09:33 +02:00
python3.html.markdown [python3] updated docs on division for python3 (#2473) 2016-10-20 15:57:55 +02:00
python.html.markdown [python/en] Set, dict, and generator comprehensions (#2298) 2016-07-03 10:47:57 +02:00
pythonstatcomp.html.markdown Update pythonstatcomp.html.markdown 2016-03-18 14:07:03 -04:00
qt.html.markdown [qt/en] Tidy up (#2391) 2016-10-01 20:52:59 +02:00
r.html.markdown Removed a conflicting line for PR merge 2016-03-11 08:33:58 -06:00
racket.html.markdown [racket/en] Add more details about Racket (#2278) 2016-06-26 15:21:13 +02:00
README.markdown Resolve conflicts from merge 2016-02-15 17:47:35 -05:00
red.html.markdown removing whitespace all over 2015-10-07 23:11:24 -04:00
rst.html.markdown [en/RST] Add RST introduction (#1723) 2016-06-26 15:34:16 +02:00
ruby-ecosystem.html.markdown Ruby 1.9.x is also retired 2015-10-06 16:08:41 +02:00
ruby.html.markdown Elixir agents/maps, Ruby conventions/docs (#2116) 2016-07-12 10:07:38 +02:00
rust-pt.html.markdown [rust/pt-br] initial translation (#2415) 2016-10-05 08:30:01 +02:00
rust.html.markdown Fix comment in Rust docs: box -> mine (#2365) 2016-09-27 16:42:40 +02:00
sass.html.markdown [sass/en] Fix typos in Sass tutorial (#2458) 2016-10-15 16:21:45 +02:00
scala.html.markdown Merge pull request #1782 from doub1ejack/scala-en-repl 2016-08-02 14:02:23 -04:00
self.html.markdown [self-en] separeated -> separated 2016-02-22 20:27:17 -07:00
smallbasic.html.markdown [smallbasic/en] minor fact check fix (#2312) 2016-07-17 01:51:57 +02:00
smalltalk.html.markdown Update smalltalk.html.markdown 2016-05-11 10:37:15 -07:00
solidity.html.markdown corrections in mapping example (#2371) 2016-09-27 16:41:22 +02:00
standard-ml.html.markdown [racket/en] Add more details about Racket (#2278) 2016-06-26 15:21:13 +02:00
swift.html.markdown Updated code according Swift v.3 (#2427) 2016-10-08 11:59:20 +02:00
tcl.html.markdown tcl: fix error in no-braces example (#2274) 2016-06-06 11:47:47 +02:00
tmux.html.markdown #1733 2016-09-06 10:26:04 +02:00
toml.html.markdown [WIP] [toml/en] Add TOML support (#2282) 2016-09-01 19:27:41 +02:00
typescript.html.markdown Added typescript-pt.html.markdown (#1699) 2016-06-26 15:03:09 +02:00
vim.html.markdown Fix typo, 'Verbs ==> 'Verbs' (#2344) 2016-08-26 10:05:48 +02:00
visualbasic.html.markdown correction 2015-11-08 23:46:41 +03:00
whip.html.markdown [whip/en] Fix typos 2015-10-31 22:46:58 -04:00
wolfram.html.markdown Rename wolfram.md to wolfram.html.markdown 2016-01-01 01:54:11 +00:00
xml.html.markdown [xml/en] Grammar, formatting. Made more 'inlined'. 2015-10-20 13:53:47 +05:30
yaml.html.markdown [yaml/en] Add more resources (#1666) 2016-04-28 09:06:12 +02:00
zfs.html.markdown Merge pull request #1644 from fliiiix/patch-1 2016-03-11 09:40:21 +01:00

Learn X in Y minutes

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.

We need YOU!...

... 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. Remember to fill in the "contributors" fields so you get credited properly!

Contributing

All contributions are welcome, from the tiniest typo to a brand new article. Translations 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 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.

For a detailed style guide, please review the full CONTRIBUTING 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 licensing included on each doc page.

Anything not covered by the above -- basically, this README -- you can use as you wish, I guess.