first-steps.tasks

{"desc":"## The User Interface\n\n### The Top Row: Projects, Account Settings and About\n\n* [ ] The CoCalc environment organizes around the concept of \"projects\".\n  The currently opened projects – just like the one you're currently in – are tabs at the very top,\n\n  - [ ] and you can go back to the overview by clicking on the \"Projects\" button on the left.\n\n\n* [ ] At the right hand side of the top bar you can click on \"Account\" to access your _account settings_. Click there now to see the available tabs.\nThey control aspects of the UI, various configuration options,\nand allow you to [subscribe](https://cocalc.com/policies/pricing.html) to the service.\n\n  - [ ] Click \"Preferences\" to see settings for your name, email address, editor settings, and so on.\n\n  - [ ] Click on the other tabs, \"Subscriptions\", \"Upgrades\", and so on for a first view of what they contain.\n\n- [ ] Just right of account settings, the _About_ tab gives you more information about what CoCalc is.\n\n- [ ] Finally, the _Connection_ dialog helps you to debug network status issues.\n\n### The Second Row: The project specific interface\n\nEach project is a collection of _files_, like on a local computer, which are organized through the \"Files\" tab.\nThe idea is to create a project for each task -- or \"project\" -- you work on.\n\n- [ ] Click on  \"Files\" at the upper left of this project. You'll see this \"first-steps.tasks\" file and a bunch of additional documents. Come back here by clicking on \"first-steps.tasks\" again or select the tab for this opened file.\n\n- [ ] Click the wrench icon to open the tab for the _project settings_.\n  It allows you to set some basic configuration of the project,\n  control how upgrades from subscriptions are applied,\n  and gives you additional status information.\n\n- [ ] You can share your projects with _collaborators_ by viewing and editing your files together. In project settings (\"Settings and configuration\"), find \"Add People to Project\" at upper right. You can search and select an existing user or invite a new user by email.\n\n- [ ] Look in _project settings_ for the section 'Project usage and quotas' and see whether your project has Internet access.\n\n<div align='right'>**3 tasks left**</div>","position":0.26873779296875,"last_edited":1510664416894,"task_id":"3d4b3385-3927-4263-a7f2-f3b7585a5b66"}
{"desc":"# Teaching with CoCalc\n\nThere is one more thing.\nCoCalc makes it easy to setup a class, hand out worksheets as assignments, collect, grade and redistribute them.\nYou no longer have to deal with setting up the computers of your students or maintaining a setup in a dedicated lab.\n\n* [ ] [CoCalc for Teaching](https://github.com/sagemathinc/cocalc/wiki/CoCalc-for-Students-and-Teachers)\n\n* [ ] [List of classes using CoCalc](https://github.com/sagemathinc/cocalc/wiki/Teaching)\n\nYou can't do much with course management without students, but let's have a look at the interface.\n\n- [ ] Create a sample course file, for example 'i-like-teaching.course'. Open the file in Cocalc and see that there are tabs for Students, Assignments, Handouts, Settings, and Shared Project.\n\n- [ ] Click on \"Settings\" and \"Shared Project\" and observe the options under these tabs.\n","position":3.498046875,"last_edited":1510664165159,"task_id":"c3535531-87b4-4f93-b785-e2885e9d9e7a"}
{"desc":"## Terminal\n\nUnder the hood, CoCalc projects are common Linux user accounts. A terminal let's you talk directly to the underlying system.\n\nWondering why the heck you would want to use such a terminal?\n\n- [ ] Start [here](https://askubuntu.com/questions/106039/so-what-is-the-advantage-of-using-the-terminal)!\n\nWant to learn more about using a terminal or Tmux? Check out\n\n- [ ] [Ryans Tutorials: Linux](http://ryanstutorials.net/linuxtutorial/)\n\n- [ ] [Using the Shell – Wikibooks Linux Guide](https://en.wikibooks.org/wiki/Linux_Guide/Using_the_shell)\n\nReady?\n\n- [ ] **Click here to open a Terminal file: [first-steps.term](first-steps.term)**","position":3.46875,"last_edited":1510664237430,"task_id":"228e9b8c-2733-4af1-bad4-f13cfbe11490","deleted":false}
{"desc":"# Hello and welcome to CoCalc!\n\nThis _task file_ serves as a quick start guide to understanding CoCalc. You can do all of the tasks here, none of the tasks here, or just some of the tasks here. It's up to you.\n\nThe **first five tasks** cover essentials of CoCalc. In each of them check off what you have read, like that: [x]. The remainder are pointers to more specific topics.\n\n**Notes:**\n\n* CoCalc is **best experienced with other people**. If you've got a random friend handy to try us out with you, go ahead and invite them to this project by clicking the chat button near the upper right corner of this file.\n\n* This file is also **searchable**: Have something in mind already like `Jupyter` or `Python`? Try typing that into the search bar near the upper left corner and following the dialogue.\n\n* Snippets labeled *-- Tandem Tactics --* are for those of you with a partner.\n\n\n","position":0.2686767578125,"last_edited":1511712919974,"task_id":"17c5b18b-3f1b-4b10-a56b-de1fb62afb79","done":0}
{"desc":"<h2 style=\"color: green;\">&#x1f386; Congratulations, all essential tasks done &#x1f386;</h2>\n\n---\n\n# Bonus Material\n\nEverything below here is extra. Items talk about different software that is readily availabe for use on CoCalc. As always any file is simultaneously openable by people you've shared your project with. This makes CoCalc great for working with other people whether your just learning Python or trying to train ML models on novel data sets.","position":3.25,"last_edited":1510664300031,"task_id":"87423380-a89d-44f7-8bf7-1aa9b342c950"}
{"desc":"## CoCalc is a platform for Collaborative Calculation in the Cloud.\n\nBut what does that mean?\n\nCollaboration means sharing the same environment with anyone by adding them to a project. This allows you to edit the same files, run the same computations, and do all of it from the exact same place (and even at the same time).\n\nBeing in the cloud means each of your projects is available on the internet which you can access any time, from any modern browser, on any computer.\n\n- Got a new device? Just slap on your favorite browser and log right in. No installs necessary.\n\n- Want to share some data analysis you wrote in Python or R? Don't worry about your friend having the right environment, just invite them to the project or share a public link with them.\n\n### File Creation\n\nBack to the tutorial, let's start with something simple:\n- [ ] Create a file named `hello_world.md`\n\nThere are a few ways to do this. Some are more obvious than others.\n- [ ] The `New` tab of this project.\n\n- [ ] The `Files` tab of this project\n\n- [ ] The terminal bar in the `Files` tab\n\nIf you figure out all of them, you're well on your way to becoming a savvy CoCalc user!\n\n** -- Tandem Tactics -- **\n- [ ] Open this `hello_world.md` file while it is also opened by an collaborator.\n\n- [ ] Make changes to the file, watch each ones cursors moving around.\n\n- [ ] Finally, let's look at the **history** for this file: click on the **TimeTravel button** (next to the green Save button) and use the slider to go back in time.\n\n<div align='right'>**2 tasks left**</div>","position":0.2687530517578125,"last_edited":1510664426903,"task_id":"cc98788b-1c83-4951-9e0c-67659ee52cb4"}
{"desc":"# The Kitchen Sink\n\nWhoa! You've made it all the way to the end! You must be one of those types that plays video games for 100% completion and not just the main story line. If you really must, here's a bucket list of things you can do in CoCalc. Good luck!\n\n- [ ] [Learn Python from Google](https://developers.google.com/edu/python/)\n\n- [ ] Work through that [Python Data Science Handbook](https://jakevdp.github.io/PythonDataScienceHandbook/) by Jake VanderPlas.\n\n- [ ] Contribute to the open-source [CoCalc Project](https://github.com/sagemathinc/cocalc)\n\n\n*If you get through all of these, [let us know](mailto:[email protected]) you super human, you.","position":3.49951171875,"last_edited":1510664138078,"task_id":"58339422-3a51-4ae7-84ab-9804003ba51d"}
{"desc":"## More information\n\nFinally, to learn more about CoCalc please consult our main Wiki and FAQ pages:\n\n* [ ] [CoCalc Tutorial](https://tutorial.cocalc.com/)\n\n* [ ] [WIKI for CoCalc](https://github.com/sagemathinc/cocalc/wiki)\n\n* [ ] [FAQ](https://github.com/sagemathinc/cocalc/wiki/FAQ)\n\n* [ ] [Troubleshooting Connection Issues](https://github.com/sagemathinc/cocalc/wiki/Troubleshooting)\n\n* [ ] [Troubleshooting Calculation Issues](https://github.com/sagemathinc/cocalc/wiki/SageWorksheetWontRun)\n\n","position":3.4990234375,"last_edited":1510504888656,"task_id":"35afd4af-6721-4e15-bf64-1df3a170708f"}
{"desc":"## Running Calculations\n\nEditing the Markdown file was only for warming up!\n\nTo get started running real **calculations** you need to create files for _interactive online computation_.\nThere are a two main choices available: **SageMath Worksheets** and **Jupyter Notebooks**.\n\nTheir key idea is to enable you to talk to the computer via interactive questions and receiving rich answers.\nWhen done, the input and associated output is recorded in the file and stored for later.\n\n* [ ] **Jupyter Notebooks** – `*.ipynb`\n\n  - [ ] **Click [here to open the companion Jupyter Notebook `jupyter-notebook.ipynb`](jupyter-notebook.ipynb)**.\n\n    WARNING: it contains some Python code. Don't worry, this [Python is a friendly one](https://docs.python.org/3/faq/general.html#why-is-it-called-python)!\n\n  - [ ] Over there, the document explains itself and when done, come back here to finish this task.\n\n  - [ ] Be audacious: create a new Jupyter Notebook, choose a different kernel like **\"R (R-project)\"** and start exploring this [language for statistical computing](http://www.r-tutor.com/r-introduction).\n<br/><br/>\n\n* [ ] **SageMath Worksheets** – `*.sagews`\n\n  - [ ] **Click [here to open the companion SageMath Worksheet `sagemath-worksheet.sagews`](sagemath-worksheet.sagews)**\n\n  - [ ] Review the worksheet and try several changes and test calculations.\n\n  - [ ] Audacious stretch goal: mix SageMath and R by changing the mode of a cell via `%r` to R. That way, you can use more than one language in the same worksheet.\n\n\n<div align='right'>**1 task left**</div>","position":0.2698974609375,"last_edited":1510586613077,"task_id":"e2841b39-01a2-4673-92be-8a245c274fcd"}
{"desc":"## Authoring Documents\n\n\n* [ ] LaTeX Documents -- `*.tex`, `*.Rnw`, `*.Rmd`\n\n  [LaTeX](https://en.wikibooks.org/wiki/LaTeX) is a sophisticated language for typesetting documents.\n  CoCalc offers an advanced side-by-side editor with a preview of your work\n  and forward/inverse search to help you navigate around.\n  It also supports running embedded calculations using [SageTeX](https://ctan.org/pkg/sagetex) or [Rnw/Knitr](https://yihui.name/knitr/demo/minimal/) for R.\n\n  - [ ] **Click [here to open the companion LaTeX document `latex-document.tex`](latex-document.tex)**\n\n  - [ ] Test some changes to the text and the Sage code in _latex.tex_.\n\n  - [ ] **Audiacious task**: upload an example `.Rnw` file from [Rnw/Knitr](https://yihui.name/knitr/demo/minimal/) and open it in Cocalc. It should run R for you and show you the results in the final PDF!\n\n\n* [ ] Publishing\n\n  - [ ] You can even use CoCalc to share files with the world. Select one of them in the \"Files\" browser, click on the \"Share...\" button. When it is published, post the link anywhere on the internet!","position":0.3125,"last_edited":1510586566572,"task_id":"078a6d0e-a38c-472f-9395-0103e45dee99"}