diff --git a/pages/DataFrames/import-csv.mdx b/pages/dataframes/import-csv.mdx similarity index 100% rename from pages/DataFrames/import-csv.mdx rename to pages/dataframes/import-csv.mdx diff --git a/pages/DataFrames/meta.json b/pages/dataframes/meta.json similarity index 100% rename from pages/DataFrames/meta.json rename to pages/dataframes/meta.json diff --git a/pages/feature-overview/block-editor.md b/pages/feature-overview/block-editor.md new file mode 100644 index 0000000..393653e --- /dev/null +++ b/pages/feature-overview/block-editor.md @@ -0,0 +1,15 @@ +# Block editor + +At the heart of Kobra is its block editor (built on [Blockly](https://developers.google.com/blockly)). The block editor is used to build programs without needing to know about complicated programming language syntax. + +On the left side, there is a toolbox, which holds all of the available blocks: + +![Screenshot of block toolbox](/toolbox.png) + +If you click on a tab, a flyout will open with the contents of it. You can then drag a block from the flyout onto the workspace. + +To build a program, connect blocks to the "on run" block. Blocks will snap together when you drag them close to each other. + +![Screenshot of a block connected to the on run block](/connecting-blocks.png) + +To get rid of a block, you can drag it onto the trash can, drag it onto the toolbox, or right click on it and select "delete block." To restore a deleted block, click on the trash can. A panel will open with its contents. \ No newline at end of file diff --git a/pages/feature-overview/dataset-uploads.md b/pages/feature-overview/dataset-uploads.md new file mode 100644 index 0000000..c2b6bae --- /dev/null +++ b/pages/feature-overview/dataset-uploads.md @@ -0,0 +1,59 @@ +# Dataset uploads + +In the machine learning world, a dataset is just a collection of data, like a table or a spreadsheet. In order to get your own data into your Kobra project, you'll need to upload them. + +## Export from a program + +Kobra uses the industry-standard CSV format for dataset imports (we support TSV and other variants too). Most spreadsheet programs have an option to export a CSV file; here's instructions for the most popular programs. + +### Google Sheets + +To export a CSV file, select the sheet you want to export, then go to File -> Download -> Comma-separated values (.csv, current sheet). The file will download to your computer. + +![Screenshot showing menus used to export CSV file from Google Sheets](/export-csv-google-sheets.png) + +### Microsoft Excel + +First, click the File tab in the upper left corner: + +![Screenshot showing file menu in Microsoft Excel](/export-csv-excel-0.png) + +Then, click "Save As," then select "Browse": + +![Screenshot showing save as menu in Microsoft Excel](/export-csv-excel-1.png) + +Then, select the "Save as type" dropdown in the resulting dialog box, then choose "CSV (Comma delimited) (*.csv)." Proceed with saving the file as you normally would. + +![Screenshot showing save dialog with save as type dropdown open in Microsoft Excel](/export-csv-excel-2.png) + +Excel will show a warning about possible data loss: + +![Screenshot showing warning in Microsoft Excel: POSSIBLE DATA LOSS: Some features might be lost if you save this workbook in the comma-delimited (.csv) format. To preserve these features, save it in an Excel file format.](/export-csv-excel-3.png) + +If you want to keep any other sheets or any formatting in your spreadsheet, click the "Save As..." button in the warning message, and save the file normally. You'll still need the CSV to upload to Kobra. + +## Import into Kobra + +First, click the Datasets tab in the upper left panel: + +![Screenshot showing Datasets tab button](/upload-dataset-1.png) + +Then, drag a file onto the panel or click the text to select a file with a dialog: + +![Screenshot showing Datasets tab contents: Drop your files here! Or click here to upload](/upload-dataset-2.png) + +Kobra will upload your dataset and display it in the panel. It will also open the DataFrames tab of the toolbox, showing the block that corresponds to the dataset: + +![Screenshot showing full Kobra UI, with a dataset showing in the Datasets panel and the DataFrames tab of the toolbox open, with an as DataFrame block at the top in a section labeled Uploaded datasets](/upload-dataset-3.png) + +You can then drag that block out to the workspace to use the data as a DataFrame. + +## Editing a dataset + +To edit a dataset, click the edit button next to the dataset name in the Datasets panel: + +![Screenshot showing section of Datasets panel labeled Uploaded datasets with the edit button next to a dataset highlighted](/edit-dataset-1.png) + +This will open a dialog with a spreadsheet-style editor. Use this to edit the dataset, then click "Save" when you are done. You can close the dialog at any time and your changes will not be saved. + +![Screenshot showing dialog box titled Edit dataset with a spreadsheet widget in the middle and save and close buttons at the bottom](/edit-dataset-2.png) \ No newline at end of file diff --git a/pages/feature-overview/meta.json b/pages/feature-overview/meta.json new file mode 100644 index 0000000..7292bbc --- /dev/null +++ b/pages/feature-overview/meta.json @@ -0,0 +1,4 @@ +{ + "block-editor": "Block editor", + "dataset-uploads": "Dataset uploads" +} \ No newline at end of file diff --git a/pages/meta.json b/pages/meta.json index 0e7b6ef..f36b8a5 100644 --- a/pages/meta.json +++ b/pages/meta.json @@ -1,7 +1,5 @@ { "index": "Introduction", - "features": "Features", - "docs": "Docs Theme", - "blog": "Blog Theme", - "advanced": "Advanced" -} + "dataframes": "DataFrames", + "feature-overview": "Feature overview" +} \ No newline at end of file diff --git a/public/connecting-blocks.png b/public/connecting-blocks.png new file mode 100644 index 0000000..8fede3f Binary files /dev/null and b/public/connecting-blocks.png differ diff --git a/public/edit-dataset-1.png b/public/edit-dataset-1.png new file mode 100644 index 0000000..10d12f9 Binary files /dev/null and b/public/edit-dataset-1.png differ diff --git a/public/edit-dataset-2.png b/public/edit-dataset-2.png new file mode 100644 index 0000000..a8ba27a Binary files /dev/null and b/public/edit-dataset-2.png differ diff --git a/public/export-csv-excel-0.png b/public/export-csv-excel-0.png new file mode 100644 index 0000000..760d943 Binary files /dev/null and b/public/export-csv-excel-0.png differ diff --git a/public/export-csv-excel-1.png b/public/export-csv-excel-1.png new file mode 100644 index 0000000..a17149f Binary files /dev/null and b/public/export-csv-excel-1.png differ diff --git a/public/export-csv-excel-2.png b/public/export-csv-excel-2.png new file mode 100644 index 0000000..6bd49ea Binary files /dev/null and b/public/export-csv-excel-2.png differ diff --git a/public/export-csv-excel-3.png b/public/export-csv-excel-3.png new file mode 100644 index 0000000..169628e Binary files /dev/null and b/public/export-csv-excel-3.png differ diff --git a/public/export-csv-google-sheets.png b/public/export-csv-google-sheets.png new file mode 100644 index 0000000..c063dcc Binary files /dev/null and b/public/export-csv-google-sheets.png differ diff --git a/public/toolbox.png b/public/toolbox.png new file mode 100644 index 0000000..8c79d3f Binary files /dev/null and b/public/toolbox.png differ diff --git a/public/upload-dataset-1.png b/public/upload-dataset-1.png new file mode 100644 index 0000000..9520b84 Binary files /dev/null and b/public/upload-dataset-1.png differ diff --git a/public/upload-dataset-2.png b/public/upload-dataset-2.png new file mode 100644 index 0000000..6109470 Binary files /dev/null and b/public/upload-dataset-2.png differ diff --git a/public/upload-dataset-3.png b/public/upload-dataset-3.png new file mode 100644 index 0000000..e4ce3e8 Binary files /dev/null and b/public/upload-dataset-3.png differ