Skip to content

Update basic tutorial #15

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
rieser opened this issue Jan 13, 2023 · 0 comments
Open

Update basic tutorial #15

rieser opened this issue Jan 13, 2023 · 0 comments
Labels
good first issue Good for newcomers

Comments

@rieser
Copy link

rieser commented Jan 13, 2023

The basic tutorial has fallen behind the Lisp-Stat project and needs to be updated. In addition to the need for a def/defdf explanation pointed out by @rieser, there are several sections in the documentation that are commented out (you only see this in the documentation source repo because Hugo removes comments from deployed documentation).

Essentially the basic tutorial is the XLisp-Stat tutorial, updated for (Common) Lisp-Stat. At the time of conversion, Lisp-Stat lacked much of the functionality mentioned in the tutorial, so it was commented out. Lisp-Stat has now closed that gap, but the basic tutorial has not kept up.

This would be a good first issue for someone that wants to learn statistics or common lisp.

Originally reported issue:
It would be good to introduce defdf somewhere in the Data Frame tutorial. While reading that section, I tried experimenting with my own .csv files, for instance, with (read-csv my-csv-file-stream) \\ (def results *), using what has been introduced so far, and it does give me back a DATA-FRAME object, and I can do a lot of manipulations on it. However, if I try to access results:my-key, I get an error, which is extremely confusing. On the other hand, if I use defdf instead of def, as indicated in the Manual (but not the Tutorial), then results:my-key works as expected.

An alternative, of course, would be to extend def to handle data frames properly.

@rieser rieser changed the title Data Frame Difference between defand defdf not explained in the tutorial Jan 13, 2023
@Symbolics Symbolics changed the title Difference between defand defdf not explained in the tutorial Update basic tutorial Jan 14, 2023
@Symbolics Symbolics added the good first issue Good for newcomers label Jan 14, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
good first issue Good for newcomers
Projects
None yet
Development

No branches or pull requests

2 participants