Commit Graph

724 Commits

Author SHA1 Message Date
Arseny Kapoulkine 7e71295c27
RFC: Deprecate getfenv/setfenv (#51) 2021-06-24 23:02:57 -07:00
vegorov-rbx 9a4487f3e9
RFC: nil-forgiving operator (#48)
Co-authored-by: Alexander McCord <11488393+alexmccord@users.noreply.github.com>
2021-06-23 12:58:00 -07:00
Arseny Kapoulkine c8af786b10
Update compatibility.md
We decided that we can't enforce strict limits for insert/remove based on analysis of Roblox games
2021-06-15 19:05:27 -07:00
Arseny Kapoulkine b439c9fcdc
Update performance.md
Restore the original sentence with tweaks; this seems like better wording since it highlights the importance of knowing the field name at compile time, no matter the notation.
2021-06-14 18:54:47 -07:00
Arseny Kapoulkine 40a175499e
Update performance.md
Remove outdated statement about table["field"] since we optimize it now the same way as table.field.
2021-06-14 10:53:26 -07:00
Arseny Kapoulkine 0fdf8824f1
Update performance.md (#50)
Add a section about vectors and libraries
2021-06-11 14:10:55 -07:00
Arseny Kapoulkine 50c22abae0
Update syntax.md (#46)
Add documentation for named arguments in function types.
2021-06-02 13:19:46 -07:00
Arseny Kapoulkine b20601af89
Update lint.md (#44)
Update FunctionUnused and ImportUnused following internal changes that make it possible to suppress the warning using _
2021-06-02 12:49:35 -07:00
Arseny Kapoulkine b490373454
Update syntax.md (#45)
Add information about type ascription syntax
2021-06-02 12:14:24 -07:00
vegorov-rbx 2a29ba1538
Update 2021-05-31-luau-recap-may-2021.md 2021-06-02 19:50:57 +03:00
vegorov-rbx 5c7a981866
Luau Recap: May 2021 (#42)
* Added May 2021 recap post

* Added missing items and fixed confusing function declaration example

* Apply suggestions from code review

Co-authored-by: Arseny Kapoulkine <arseny.kapoulkine@gmail.com>

* Small fix

Co-authored-by: Arseny Kapoulkine <arseny.kapoulkine@gmail.com>
2021-06-02 13:19:15 +03:00
Arseny Kapoulkine e8a58ea42f
Update if-expr RFC with mid-block return interaction (#43)
We don't have mid-block return support yet and it's not clear if we will due to similar grammatical issues with this wrt function calls, but noting this for completeness (thanks @alexmccord for bringing this up)
2021-06-01 15:45:43 -07:00
vegorov-rbx 7ab5a3a2db
Mark 'Named Function Type Arguments' status as implemented (#41) 2021-05-31 21:07:37 +03:00
Lily Brown 43d606fad4
RFC: Sealed table subtyping (#38) 2021-05-31 10:39:09 -07:00
Arseny Kapoulkine fff104b439
Rename linting pass to match internal changes
The name is cleaner and more correct
2021-05-30 11:55:52 -07:00
Andy Friesen fc4cfede58
Document how to actually use an exported type from another module. (#40) 2021-05-28 10:31:47 -07:00
Alexander McCord cc399fa98d
RFC: Singleton types (#37)
Co-authored-by: Arseny Kapoulkine <arseny.kapoulkine@gmail.com>
2021-05-28 09:13:44 -07:00
Arseny Kapoulkine b2b0c33b5e Update CNAME 2021-05-27 19:00:09 -07:00
Arseny Kapoulkine a4fe638b17 Create CNAME 2021-05-27 18:52:43 -07:00
Arseny Kapoulkine d6ca8b2ce3 Delete CNAME 2021-05-27 18:33:38 -07:00
Arseny Kapoulkine d3b551e266 Create CNAME 2021-05-27 18:32:05 -07:00
Arseny Kapoulkine d40107dc60
Add RFC status fields (#39)
It seems more consistent and unambiguous if we mark RFCs as being
implemented when the implementation lands instead of expecting to
cross-reference documentation. That also makes it easier for us to flag
stale RFCs.
2021-05-17 18:19:49 -07:00
Alexander McCord 8956c7448e
RFC: Allow method call on string literals (#34) 2021-05-17 16:41:55 -07:00
vegorov-rbx 0f1f6609b1
RFC: Named Function Type Arguments (#36)
Introduces syntax for optional names of function type arguments.
2021-05-13 09:02:51 -07:00
Alan Jeffrey 674846e7cf
Generic Functions RFC (#33)
* Added generic functions RFC

Co-authored-by: Tiffany Bennett <tiffany@tiffnix.com>
2021-05-12 10:48:10 -05:00
Arseny Kapoulkine 8091a330f5
Update TEMPLATE.md
Change the title to use expected Title case.
2021-05-06 19:29:16 -07:00
Arseny Kapoulkine fb67f5760c
Delete assert-return RFC
(this analysis should have been done before the RFC but the thought never crossed my mind)

There's 63K assertions in all luarocks repositories combined. Out of this, around ~600 assertions would be broken as a result of this change. This is ~1% which is pretty uncomfortable (I was hoping for a couple of odd unit tests) - as such this RFC is going to get closed. We will maintain the current behavior of assert and try to adapt type checker to be reasonably useful instead.

The common thread between all of these cases (many of them target custom APIs although some target core APIs like string.match) is that assert is used together with a function that either returns nil (for errors), or multiple arguments. Under these conditions multi-arg assert is useful.

A couple examples:

```
out_r, out_w = assert(unix.pipe())
local header, body = assert(data:match "(.-\r\n)\r\n(.*)")
local z85_secret_key, z85_public_key = assert(zmq.curve_keypair())
local _, r = assert(coroutine.resume(co, msg))
```
2021-05-04 22:15:14 -07:00
Arseny Kapoulkine cbc99c3222
Update syntax.md
Fix typo: `nunber` -> `number`

Fixes #35.
2021-05-04 18:57:48 -07:00
Arseny Kapoulkine 26be211e5d
Update README.md
Emphasize the rfc label even more.
2021-05-04 16:23:45 -07:00
Arseny Kapoulkine a6844a8247 Add emphasis to use of label. 2021-05-04 00:31:30 -07:00
Arseny Kapoulkine ba2138ce10
Add more accepted RFCs. (#32)
This finishes the set of fully baked/accepted RFCs; 3 more proposals have been accepted but not implemented yet and will be submitted separately as actual RFCs.
2021-05-04 00:13:57 -07:00
Arseny Kapoulkine e2176e35e1
Establish an RFC process (#29)
This is going to apply to language and core library changes and will supplant the internal Roblox API proposal process for Luau only.
2021-05-03 18:52:43 -07:00
vegorov-rbx b8627707c4
Luau Recap April 2021 (#28)
* Base for the April post

* Finished April 2021 recap post

* Removed features that are not enabled yet (bye, type-checking section)

* Update docs/_posts/2021-04-30-luau-recap-april-2021.md

Co-authored-by: Arseny Kapoulkine <arseny.kapoulkine@gmail.com>

* Update docs/_posts/2021-04-30-luau-recap-april-2021.md

Co-authored-by: Arseny Kapoulkine <arseny.kapoulkine@gmail.com>

* Update docs/_posts/2021-04-30-luau-recap-april-2021.md

Co-authored-by: Arseny Kapoulkine <arseny.kapoulkine@gmail.com>

* Added 'Coming Soon' for type refinements

Co-authored-by: Arseny Kapoulkine <arseny.kapoulkine@gmail.com>
2021-05-03 23:05:05 +03:00
Arseny Kapoulkine 93fb768a64
Update compatibility.md
Add a note about os.time
2021-04-26 14:13:20 -07:00
Arseny Kapoulkine 258966863c
Update compatibility.md (#27)
Call out the upcoming change to `print` and slightly reword a couple of rows. Also add a list of differences from 5.x that was previously requested (the list is likely incomplete)
2021-04-21 10:42:27 -07:00
Andy Friesen bf63d29c9a
Document the duplicate function lint (#26) 2021-04-14 14:29:28 -07:00
canada 149e687d73
Add missing bracket (#25) 2021-04-12 08:44:43 -07:00
Arseny Kapoulkine 51758557e6
Update performance.md
Correct performance note re: table.insert after a recent update.

Fixes #23.
2021-04-02 22:37:23 -07:00
Arseny Kapoulkine 094d5a0e09
Update 2021-03-29-luau-recap-march-2021.md 2021-03-31 20:13:19 -07:00
Arseny Kapoulkine 8d712c47b6
Update typecheck.md 2021-03-31 20:12:43 -07:00
Andy Friesen 2d641976ee
Clip references to Array<T> (#21)
Co-authored-by: Arseny Kapoulkine <arseny.kapoulkine@gmail.com>
2021-03-31 14:24:44 -07:00
Alan Jeffrey 0ab29a02e2
Add Atom feed (#22) 2021-03-31 14:24:26 -07:00
Alan Jeffrey 0b6977554b
Added section on generic functions (#20) 2021-03-31 12:53:21 -07:00
Alan Jeffrey 73b34e15c0
Luau Recap March 2021 (#19)
Co-authored-by: Arseny Kapoulkine <arseny.kapoulkine@gmail.com>
2021-03-30 16:45:51 -07:00
ccuser44 e051e33482
Removed incorrect info (#14)
* Removed incorrect info

The manual says Luau does not support hexadecimal \0x, Unicode \u and \z
when this clearly isn't the case.
This is also quite confusing as just a bit below it says it does support them.

Co-authored-by: Arseny Kapoulkine <arseny.kapoulkine@gmail.com>
2021-03-30 15:54:58 -07:00
Max ed845e6924
Less ambiguity to what 'SECRET TOOL' is? (#18)
Remove information about internal tooling altogether

Co-authored-by: Arseny Kapoulkine <arseny.kapoulkine@gmail.com>
2021-03-30 15:53:31 -07:00
Lily Brown a124f53628
Document variadic types (#17) 2021-03-26 16:07:34 -07:00
Alexander McCord 5f49e3fd95
Add missing docs for multiple returns. (#16) 2021-03-23 12:58:16 -07:00
Arseny Kapoulkine 98494e7ee8 Replace logo and add it as a favicon & actual logo
Thanks to Brad Sharp for the design.
2021-03-16 20:30:31 -07:00
Arseny Kapoulkine 0802697a87
Update navigation.yml
Add compatibility link
2021-03-15 21:56:50 -07:00
Arseny Kapoulkine ab913e5bc5
Update compatibility page
This brings the page in line with other pages by adding TOC, removing duplicate header and moving it to the correct location in the tree.
2021-03-15 21:56:18 -07:00
tacheometry 710547df83
Fix paranthesis (#13) 2021-03-14 16:29:46 -07:00
Alan Jeffrey 6c709f8e65
Added News section (#12)
* Add outline News section

* First draft Feb 2021 Recap

* Fixed image links

* Removed type definition files and refinements

* Added Luau Type Checking Release

* Added Luau Type Checking Beta

* Added Luau Recap August 2020

* Added Luau Recap June 2020

* Fixed code typos

* Formatting

* Removed mention of class declarations

* Rename 2020-06-20-luar-recap-june-2020.md to 2020-06-20-luau-recap-june-2020.md

* Add luau-recap-feb2021-benchmark.png

* Add luau-recap-february-2021-benchmark.png

* Delete luau-recap-feb2021-benchmark.png

* Added some more miscellaneous improvements

* Update 2021-03-01-luau-recap-february-2021.md

Expand on perf. improvements and mention table.clear.

* Update 2021-03-01-luau-recap-february-2021.md

* Update 2021-03-01-luau-recap-february-2021.md

* Removed the navigation link to Home as it didn't fit on mobile

* Removed unneeded file

* Added Luau Recap May 2020

* Added Debugger improvements

* Added Luau Recap Feb 2020

* Added Luau Recap Nov 2019

* Added a debugger screenshot

* Added image assets

Co-authored-by: Arseny Kapoulkine <arseny.kapoulkine@gmail.com>
2021-03-02 12:45:21 -08:00
AtomicOperation d04a41fcff
Change to minimal-mistakes theme (#11)
Use minimal-mistakes theme. Add a splash front page and a getting started page.
2021-02-12 12:26:08 -08:00
Kyle 41564d281c
docs: fix minor typos (#8) 2021-01-27 19:26:39 -08:00
Arseny Kapoulkine 44cdeb07cc
Update lint.md
Add DeadLocal warning description
2021-01-27 17:34:20 -08:00
Alexander 93f9e5e824
Minor improvements in type checking docs (#9)
It was somewhat outdated from the current Luau world. Some changes to fix that problem.

1. Global assignments are now allowed in nonstrict mode.
2. The example that assigns to `x` from the argument `y` in the function `f` was needlessly complicated. I elected to delete it.
3. Require tracing docs shouldn't need to explain the three possible outcomes.
2021-01-20 11:07:04 -08:00
Arseny Kapoulkine 5e069fa04a
Update limited-terms-of-use.md 2020-12-14 23:22:56 -08:00
Arseny Kapoulkine 83d6132e1d
Update limited-terms-of-use.md 2020-12-14 16:34:01 -08:00
rblanckaert 8f5ab4c47c
Create limited-terms-of-use.md (#7) 2020-12-07 12:01:37 -08:00
Arseny Kapoulkine ffa3c9fe7a
Update index.md (#6)
Add casing and pronunciation guide
2020-12-02 15:57:25 -08:00
Arseny Kapoulkine 43fed897c1
Update typecheck.md 2020-11-02 12:06:08 -08:00
Arseny Kapoulkine 9d4f338473
Update syntax.md
Add short-hand array like table syntax.
2020-10-20 17:47:48 -07:00
Arseny Kapoulkine ad9f2ac5d0
Update typecheck.md
Add short hand array like type syntax
2020-10-20 17:46:29 -07:00
Arseny Kapoulkine 98402c3798
Update performance.md 2020-10-07 12:07:13 -07:00
Arseny Kapoulkine 7480d62ba9
Update typecheck.md
Tweak Roblox types section a tiny bit
2020-09-30 11:25:18 -07:00
Alexander 8e38c0ec7d
Fix function type annotation grammar in docs. (#5) 2020-08-11 16:56:07 -07:00
Arseny Kapoulkine 3be82035bf
Update lint.md (#4)
Add TableLiteral docs
2020-08-05 16:56:59 -07:00
Arseny Kapoulkine a0cd6aa160
Update index.md 2020-08-05 16:07:44 -07:00
Arseny Kapoulkine a78be01124
Update why.md
Tiny spelling fix
2020-08-05 16:06:26 -07:00
Arseny Kapoulkine 637e171a9b
Update lint.md (#3)
Document new FormatString lint
2020-07-31 20:55:35 -07:00
Arseny Kapoulkine fe59e0b5ac
Update README.md 2020-07-30 18:02:36 -07:00
Arseny Kapoulkine ac53e4efc0
Update compatibility.md (#2)
This reflects the code changes we've made to upgrade string library:

- Updated the match implementation to 5.2, adding support for `%g` and `\0` in patterns
- Added string pack/unpack from 5.3
2020-07-24 11:10:59 -07:00
Arseny Kapoulkine 6163ac78b5
Update performance.md
Add a section about upvalue optimizations.
2020-06-29 09:42:18 -07:00
Arseny Kapoulkine c4148cea83
Update index.md 2020-06-25 18:11:49 -07:00
Arseny Kapoulkine 9ca9cc8f7c
Add _layouts/default.html
The repository is currently private and there doesn't seem to be a different way to hide the link to it.
2020-06-24 13:14:15 -07:00
Arseny Kapoulkine 053061e3e8
Update syntax.md
Fix hexadecimal escape sequences
2020-06-24 12:20:58 -07:00
Arseny Kapoulkine 2cd63aa589
Update typecheck.md
Wording changes in unknown symbols
2020-06-23 09:36:57 -07:00
Arseny Kapoulkine 9939c5c361
Update performance.md 2020-06-22 16:28:16 -07:00
Alexander McCord af24404615 fix broken link 2020-06-19 00:06:05 -07:00
Alexander McCord 149c14f115 Minor wording changes to typecheck.md 2020-06-18 23:55:19 -07:00
Alexander McCord aac31bdc1f Add unknown symbols to typecheck.md 2020-06-18 23:36:14 -07:00
Alexander McCord 593285c012 Add typing idiomatic OOP section 2020-06-18 21:57:55 -07:00
Alexander McCord e3a161e950 Add Modules interactions section to typecheck.md 2020-06-18 18:51:51 -07:00
Arseny Kapoulkine 68264852a9
Update typecheck.md (#1) 2020-06-18 18:43:38 -07:00
Alexander McCord 876b2ad644 docs: Update typechecking.md 2020-06-18 16:23:23 -07:00
Arseny Kapoulkine 7252cbdede
Update sandbox.md
Exclude debug.getinfo for now as we haven't enabled it yet for Roblox
2020-06-18 11:18:18 -07:00
Alexander McCord 2e6354f4a7 docs: demote empty statements to shrug 2020-06-12 09:55:16 -07:00
Arseny Kapoulkine 3eec4437d2 docs: Wording 2020-06-12 08:07:35 -07:00
Arseny Kapoulkine 479189107f docs: Hopefully final tweak 2020-06-12 02:43:40 -07:00
Arseny Kapoulkine 71b40ba34e docs: Cleanup compiler wording 2020-06-12 02:40:28 -07:00
Arseny Kapoulkine 2d07039efd docs: Amend goals 2020-06-12 02:31:33 -07:00
Arseny Kapoulkine 064623aa4d docs: Finish performance section
Still missing details on Vector3 and GC but both of these are in
development so aren't ready to be documented anyway.
2020-06-12 02:29:30 -07:00
Arseny Kapoulkine c8007a73b8 docs: Add a couple perf notes 2020-06-12 01:48:10 -07:00
Arseny Kapoulkine 754f202f78 docs: Start fleshing out performance section
There's still more to document here.
2020-06-12 01:44:56 -07:00
Arseny Kapoulkine a56260d3f0 docs: Add interrupts info 2020-06-12 01:01:33 -07:00
Arseny Kapoulkine d64896a324 docs: Add open source note as the Q comes up. 2020-06-12 00:34:56 -07:00
Arseny Kapoulkine fdfd94dd00 docs: Finish sandboxing section
Also add a note about ephemeron tables to compatibility.
2020-06-12 00:28:39 -07:00
Arseny Kapoulkine b5c00ec43a docs: Sidebar styling fix 2020-06-11 23:40:39 -07:00
Arseny Kapoulkine c350af1be5 docs: Update sidebar nav 2020-06-11 23:39:27 -07:00