cnbbooks / lfe-manual Goto Github PK
View Code? Open in Web Editor NEWThe LFE MACHINE MANUAL
Home Page: https://cnbbooks.github.io/lfe-manual/
License: Creative Commons Attribution Share Alike 4.0 International
The LFE MACHINE MANUAL
Home Page: https://cnbbooks.github.io/lfe-manual/
License: Creative Commons Attribution Share Alike 4.0 International
Categorize according to 4 levels:
Categorize according to 4 levels:
Sections:
Gitbook has changed its services and some of our stuff no longer builds. It would be nice to use some tooling that doesn't depend upon a service going away ... and I'd love to not have to use Ruby.
Ideally, whatever solution we use going forward should satisfy these conditions:
I'll see if it meets our other criteria ...a
Categorize according to 4 levels:
This will mean we won't have to have separate branches for build and publish. I've done this in another mdbook repo somewhere fairly recently -- I'll get a link to that repo to use as an example.
Tasks:
Moved from lfe/docs#30
I have created this ticket based upon feedback from here:
In-REPL (set
), in assignments with let
, function heads, lambda functions, etc.
Tasks:
Extract useful bits from http://docs.lfe.io/current/user-guide/diving/1.html
Add them here: https://cnbbooks.github.io/lfe-manual/part2/data-types/index.html
Replace the HTML at https://github.com/lfe/docs/blob/master/docs/current/user-guide/intro/1.html with an HTML meta redirect to https://cnbbooks.github.io/lfe-manual/part2/data-types/index.html
Extract useful bits from http://docs.lfe.io/current/user-guide/diving/2.html
Add them here:
Replace the HTML at https://github.com/lfe/docs/blob/master/docs/current/user-guide/diving/2.html with an HTML meta redirect to https://cnbbooks.github.io/lfe-manual/part2/lists/index.html
Extract useful bits from http://docs.lfe.io/current/user-guide/diving/3.html
Add them here: https://cnbbooks.github.io/lfe-manual/part2/byte-bin/index.html
Replace the HTML at https://github.com/lfe/docs/blob/master/docs/current/user-guide/diving/3.html with an HTML meta redirect to https://cnbbooks.github.io/lfe-manual/part2/byte-bin/index.html
Create a new "Variables" section in https://cnbbooks.github.io/lfe-manual
Extract useful bits from http://docs.lfe.io/current/user-guide/diving/4.html
Add them to the new variables section
Replace the HTML at https://github.com/lfe/docs/blob/master/docs/current/user-guide/diving/4.html with an HTML meta redirect to the new location (e.g., https://cnbbooks.github.io/lfe-manual/part2/vars/index.html)
Extract useful bits from http://docs.lfe.io/current/user-guide/diving/5.html
Add them here: https://cnbbooks.github.io/lfe-manual/part2/patterns/index.html
Replace the HTML at https://github.com/lfe/docs/blob/master/docs/current/user-guide/diving/5.html with an HTML meta redirect to https://cnbbooks.github.io/lfe-manual/part2/patterns/index.html
Categorize according to 4 levels:
And instead of the repos, we should use the hex.pm entries.
Moved from: lfe/docs#29
Categorize according to 4 levels:
Tasks:
Extract useful bits from http://docs.lfe.io/current/user-guide/data/1.html
Add them here: https://cnbbooks.github.io/lfe-manual/part2/lists/index.html
Replace the HTML at https://github.com/lfe/docs/blob/master/docs/current/user-guide/data/1.html with an HTML meta redirect to https://cnbbooks.github.io/lfe-manual/part2/lists/index.html
Create new section in Part III for list comprehensions (probably after "Closures"? anonymous functions will be covered in the new "Functions" chapter, but the "Closures" chapter should immediately follow that one)
Extract useful bits from http://docs.lfe.io/current/user-guide/data/2.html
Add them to the new list comp chapter
Replace the HTML at https://github.com/lfe/docs/blob/master/docs/current/user-guide/data/2.html with an HTML meta redirect to the new list comp chapter
Extract useful bits from http://docs.lfe.io/current/user-guide/data/3.html
Add them here: https://cnbbooks.github.io/lfe-manual/part2/proplists/index.html
And here https://cnbbooks.github.io/lfe-manual/part2/dicts/index.html
Replace the HTML at https://github.com/lfe/docs/blob/master/docs/current/user-guide/data/3.html with an HTML meta redirect to https://cnbbooks.github.io/lfe-manual/part2/proplists/index.html
Extract useful bits from http://docs.lfe.io/current/user-guide/data/4.html
Add them here: https://cnbbooks.github.io/lfe-manual/part2/records/index.html
Replace the HTML at https://github.com/lfe/docs/blob/master/docs/current/user-guide/data/4.html with an HTML meta redirect to https://cnbbooks.github.io/lfe-manual/part2/records/index.html
There are a handful of phases involved ... and they're not actually linear/sequential, they're more combined + iterative. Which means that, even if a section looks "done" it's actually not. They will be tuned over and over ๐ So, here are the "phases":
Note: this is a work in progress, it's not being published to lfe.io/books yet. Drafts are published here: https://cnbbooks.github.io/lfe-manual/current
LFE:
Erlang:
Lisp:
Rust:
If you are interested in contributing to this effort, the most important preparatory steps you can take are:
Categorize according to 4 levels:
Categorize according to 4 levels:
Categorize according to 4 levels:
This was actually the template that was used when envisioning this book, back in 2014 and 2015, per discussions with @rvirding on IRC, etc.
Here's a searchable PDF: https://drive.google.com/file/d/0B1AjIfhQqXG_Um1sMVh5Ump2R2M/edit
Possibilities, with the understanding that only "LFE CHINE NUAL" would appear on the (green) cover:
This will allow us to deprecate (and move here) the following:
Starting with LFE 2.0, let's start tracking "Current" as well as all published version numbers, just like with other docs, e.g., https://github.com/cnbbooks/lfe-rebar3-command-reference/tree/7dec0fe5f79328958b60ae57445c9a5c61136a9a
See lfe/docs#16
Categorize according to 4 levels:
The content at https://en.wikibooks.org/wiki/Haskell is already categorized according to the 4 levels:
Data types, expressions, etc.
Right now, "Pattern Matching" gets its own section towards the end of Part II -- Let's move that to the beginning of Part II, even before data types are discussed. Give an intro about it, that it is integral to the language, and every type section will show how to match that particular type.
Then do the same in the subsequent sections of Part III.
I keep using the old docs site for some things (such as the list comprehension examples). Lets get that content moved into the manual, and then just link to it from the other pages.
Content to move:
Everything else can be scrapped.
Conss -> Cons Cells
New sections:
No need for a Beginner's Guide -- that's the whole "Getting Started" section.
New "Tooling" subsections:
A declarative, efficient, and flexible JavaScript library for building user interfaces.
๐ Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. ๐๐๐
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google โค๏ธ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.