edge function doc

Author: landsman

.docs/_cron.md

@@ -6,6 +6,13 @@ See [Supabase Documentation](https://supabase.com/docs/guides/cron).
 
 You have to run the following commands in SQL Editor of your Supabase project.
 
+## Generate cron tab
+
+1. Fill out root `.env` file with variables
+2. run tests: `deno run tests`
+3. cron install queries will be generated into the file `cron_jobs.sql` in the root
+4. visit supabase dashboard and run these queries in SQL editor
+
 ## GUI
 
 There is actually a UI where you can manage your jobs very easily.
@@ -16,18 +23,12 @@ https://supabase.com/dashboard/project/***/integrations/cron/jobs
 
 *Replace your project ID in the URL*.
 
-## Create a new job
-
-Fill out .env file with variables and run tests. Cron will be generated to the file.
-
-```bash
-deno run tests
-```
-
 ## Remove existing job
 
 Replace ID by number from your database of already existing cron.
 
 ```bash
 select cron.unschedule(3);
 ```
+
+Or you can do this via GUI as well.

.docs/_edge_functions.md

@@ -0,0 +1,12 @@
+# Edge Functions
+
+Basically the same as AWS Lambda, but much better integrated in the whole system. Check [Supabase Documentation](https://supabase.com/docs/guides/functions).
+
+Code is located in: `./supabase/functions/*`.
+
+Each function can run a very short time (up to 2s) then it's terminated. So it's good to write small scripts with pagination. Database can give you great tooling for that.
+
+Unexpected errors are handled by Sentry. That works good. What should be tweaked is notification about terminated function. It can be done probably by event pushing to Sentry as well.
+
+
+

README.md

@@ -6,7 +6,7 @@ The purpose of this project is to store data about the music I listen to in my o
 I also want to have fun while learning more about [Supabase](https://supabase.com) native features.
 
 Currently, I am downloading all historical data from my Last.fm profile 
-using its API to PostgresSQL via [Edge Functions](https://supabase.com/docs/guides/functions) and the [built-in cron extension](https://supabase.com/docs/guides/cron),
+using its API to PostgresSQL via [Edge Functions](.docs/_edge_functions.md) and the [built-in cron extension](.docs/_cron.md),
 which run every 5 minutes and download 500 items.
 
 ## Roadmap