Commit Graph

15 Commits

Author SHA1 Message Date
Bob Nystrom
d9f608fa3f fix: correct variable naming and constructor syntax in FAQ code examples
- Rename `acc` to `account` in Lua and Wren examples for consistency
- Fix Wren constructor syntax from `this new` to `construct new`
- Remove hyphen from "one-byte" to match standard phrasing
2016-03-07 15:41:00 +00:00
Bob Nystrom
909c242a03 chore: reorganize doc site structure by moving core docs under modules/ and removing category metadata
Restructure the documentation hierarchy to prepare for documenting additional built-in modules. Move all core library documentation from `doc/site/core/` to `doc/site/modules/core/`, rename `modules.markdown` to `modularity.markdown`, remove `^category` metadata lines from all affected pages, update cross-reference links to use relative paths under the new structure, and add a TODO placeholder to the Class class page.
2015-11-08 21:31:22 +00:00
Bob Nystrom
efcc4d07c7 docs: reorganize language guide into linear narrative with renamed sections and navigation links 2015-11-07 19:09:04 +00:00
Bob Nystrom
6bda720b71 feat: replace all :::dart code fence markers with :::wren in documentation
Add a custom Pygments lexer plug-in for Wren syntax highlighting, update contributing docs with setup instructions for the lexer, and switch every `:::dart` annotation across all doc/site markdown files to `:::wren` so code examples render with the correct language grammar.
2015-09-22 14:59:54 +00:00
Bob Nystrom
e19ff59cce feat: replace new keyword with this constructor syntax and ClassName.new() calls across core library and docs
Replace all uses of the `new` reserved word with explicit `this new()` constructor definitions and `ClassName.new()` instantiation calls in builtin/core.wren. Update all documentation files (classes.markdown, fiber.markdown, fn.markdown, sequence.markdown, error-handling.markdown, expressions.markdown, fibers.markdown, functions.markdown) to reflect the new constructor syntax, removing `new` keyword examples and replacing them with `ClassName.new()` patterns and `this new()` definitions.
2015-07-10 16:18:22 +00:00
Thorbjørn Lindeijer
bf3590d47a docs: fix inconsistent initial balance in Wren example and broken sentence grammar 2015-03-01 14:18:58 +00:00
Bob Nystrom
0d318e9545 feat: add stack vs register-based VM design rationale to FAQ
Add a new FAQ entry explaining why Wren uses a stack-based bytecode VM
instead of a register-based one. The entry covers the trade-offs between
the two approaches, references Lua's switch to register-based VM, and
explains that Wren's operator-overloading design makes register-based
optimizations less beneficial.
2015-01-09 05:06:10 +00:00
Bob Nystrom
98d358142d docs: reflow all markdown files to 80-char width and add control-flow page with branching/looping content 2015-01-04 07:27:02 +00:00
Bob Nystrom
235518637a style: update site color scheme, typography, and copy across documentation pages 2014-08-19 14:35:20 +00:00
Bob Nystrom
6ed15da597 feat: add category metadata to doc pages and switch code blocks to dart syntax
Add `^category` front matter to all language, types, and reference doc pages for site navigation restructuring. Replace `:::wren` and `:::java` code block annotations with `:::dart` across multiple files. Create new stub pages for core-libraries, embedding-api, and contributing under the reference category. Remove the old embedding and getting-involved stub pages.
2014-04-15 04:23:46 +00:00
Bob Nystrom
71783400ae docs: add documentation for conditional operator, fibers, break statements, and ranges; remove placeholder usage page 2014-04-11 17:45:20 +00:00
Bob Nystrom
e8d31eddaf feat: replace hand-written CSS with Sass compilation and update site design with new fonts and layout
- Delete doc/site/style.css and add doc/site/style.scss with Sass variables, Dosis header font, box-sizing, absolute header positioning, and link hover effects
- Update template.html to reference Dosis font, lowercase nav headings, and change tagline to "a classy little scripting language"
- Add .sass-cache/ to .gitignore and rename Makefile phony target from docs to builtin
- Modify generate_docs.py to compile style.scss via sass subprocess instead of copying static CSS
- Tweak performance.markdown and qa.markdown for minor wording improvements
2014-04-05 22:39:02 +00:00
Bob Nystrom
781ccf3fb6 docs: revise branching, classes, index, looping, qa, syntax docs and add concurrency/error-handling nav entries 2014-01-21 05:44:51 +00:00
Bob Nystrom
192ce49dc3 fix: correct typos in qa.markdown for Wren documentation
- Fixed "convention OOP background" to "conventional OOP background"
- Fixed "object-oriented programming" hyphenation in Lua example
- Fixed italic emphasis on "you" in rhetorical question
- Corrected other minor typographical errors throughout the document
2014-01-14 04:23:11 +00:00
Bob Nystrom
4026878ac6 docs: add branching, looping, classes, method calls, and Q&A documentation with updated navigation 2013-12-28 17:37:41 +00:00