Closed smilo7 closed 2 years ago
thanks Milo! pushing fixes to develop
https://sema.codes/tutorial/03-machine-learning/07-rl-gosling/
- in part 2: live machine learning section, third code example box should contain example with learn instead of predict.
Finished changes if they were still applicable (in upcoming PR) Some issues i have moved to a new issue as its a larger problem that needs to be addressed on its own. See #356
Closing this now.
Some minor usability tweaks and small bugs such as broken links. Organised by each section of the tutorial with comments under each section if there were any.
Basics
https://sema.codes/tutorial/01-basics/01-introduction/
landing page of tutorial the link for GitHub goes to mimic-sussex webpage rather than the sema repo. this should be changed to link directly to https://github.com/mimic-sussex/sema.https://sema.codes/tutorial/01-basics/02-interface/
Machine learning model editor, should now reference the JavaScript button that is used to launch it.^^ leaving these bits unchanged till new design is implemented otherwise we will have to just edit this again.
https://sema.codes/tutorial/01-basics/03-editors/
Change reference from model editor to JavaScript editor?Section on Model Editor: make "part 3" in text a relative link to the part 3 tutorials.Section on Grammar editor: make "part 4" in text a relative link to the part 4 tutorials- In the grid, liveCodeEditor and modelEditor are launched but grammar editor is not although it is referenced in the text.https://sema.codes/tutorial/01-basics/04-widgets/
Bold bits above moved to a new issue #356
Introduction to the Default Language
https://sema.codes/tutorial/02-live-coding/01-introduction/
Last line references "follow the tutorials below". there are no tutorials below, perhaps best to suggest navigate to the next tutorial with the arrows to explore more features..https://sema.codes/tutorial/02-live-coding/03-variables/
Styling of grey tutorial box does not run to the bottom of page. Minor styling issue.https://sema.codes/tutorial/02-live-coding/04-sampling/
Link to samples does not work. Would be a good idea to link to a page in the documentation that lists all the samples.Machine Learning
https://sema.codes/tutorial/03-machine-learning/01-introduction/
reference to ML window might be changed to JavaScript Window. 4th paragraph.https://sema.codes/tutorial/03-machine-learning/03-streaming-ml-lc/
Uses LC and JS to reference what to paste into each window. Should this format be used throughout the tutorials?Just clarified what these abbreviations meant here instead.https://sema.codes/tutorial/03-machine-learning/05-creating-buffers/
Spelling mistake in second paragraph "comppile" instead of "compile".https://sema.codes/tutorial/03-machine-learning/06-ml-libraries/
- Perhaps style the links to TensorFlow JS GitHub for example, rather than the raw links.- Link to import tensorflow JS in the code is missing. Add this:importScripts("https://cdn.jsdelivr.net/npm/@tensorflow/tfjs/dist/tf.min.js");
to code.Needs an importScript link to Lalolib code example too.https://sema.codes/tutorial/03-machine-learning/07-rl-gosling/- in part 2: live machine learning section, third code example box should contain example with learn instead of predict.https://dev.sema.codes/tutorial/03-machine-learning/10-regression2/- change .TRAIN to .COLLECT (feedback from workshop)(more to come here)
Language Design
https://sema.codes/tutorial/04-language-design/01-introduction/