{"id":21216399,"url":"https://github.com/datacoves/docs","last_synced_at":"2025-08-23T13:38:58.649Z","repository":{"id":61261999,"uuid":"539519658","full_name":"datacoves/docs","owner":"datacoves","description":"Datacoves public documentation","archived":false,"fork":false,"pushed_at":"2025-08-08T18:44:27.000Z","size":49822,"stargazers_count":3,"open_issues_count":0,"forks_count":4,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-08-17T23:44:02.394Z","etag":null,"topics":["airbyte","airflow","analytics","bigquery","datacoves","dataops","dbt","elt","etl","redshift","snowflake","superset"],"latest_commit_sha":null,"homepage":"https://docs.datacoves.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/datacoves.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-09-21T14:04:07.000Z","updated_at":"2025-08-08T18:44:26.000Z","dependencies_parsed_at":"2023-12-29T17:23:07.826Z","dependency_job_id":"19b9487d-1296-42e6-bc35-d3446d3f7cfd","html_url":"https://github.com/datacoves/docs","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/datacoves/docs","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/datacoves%2Fdocs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/datacoves%2Fdocs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/datacoves%2Fdocs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/datacoves%2Fdocs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/datacoves","download_url":"https://codeload.github.com/datacoves/docs/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/datacoves%2Fdocs/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271749183,"owners_count":24814141,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-23T02:00:09.327Z","response_time":69,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["airbyte","airflow","analytics","bigquery","datacoves","dataops","dbt","elt","etl","redshift","snowflake","superset"],"created_at":"2024-11-20T21:51:56.810Z","updated_at":"2025-08-23T13:38:58.608Z","avatar_url":"https://github.com/datacoves.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Datacoves Docs\n\n## Welcome to the Datacoves Documentation\n\nOur Mission is to be the _fast track to the Modern Data Stack_ so you can focus on **Delivering Results Quickly.**\n\n## Contributing\n\nWe use [docsify](https://docsify.js.org/) to generate our documentation.\n\nIt's simple, you just need to [learn Markdown](https://jhildenbiddle.github.io/docsify-themeable/#/markdown).\n\n### Install docsify\n\nIt is recommended to install docsify-cli globally, which helps initializing and previewing the website locally.\n\n```shell\nnpm i docsify-cli -g\n```\n\n### Preview it\n\n```shell\ndocsify serve docs\n```\n\n### Add new links to the sidebar\n\nOpen [docs/\\_sidebar.md](docs/_sidebar.md) and add the new links accordingly.\n\n## Static HTML Builder\n\nBecause Docsify isn't search engine friendly, and because they don't currently support a server side rendering feature, we have made our own 'compiler' to convert the documentation into static HTML.\n\nTo use it, set up a Python virtual environment such as:\n\n```\npython3 -m venv venv\n```\n\nThen activate it:\n\n```\nsource venv/bin/activate\n```\n\nInstall dependencies:\n\n```\npip3 install -r requirements.txt\n```\n\nThen run the compiler.  We recommend using the directory named 'output' for the results:\n\n```\npython3 -m doc_compiler docs output\n```\n\nNote that the resulting files, if just opened from the file system with a web browser, won't handle their paths correctly.  Thus, you have to use some kind of web server to service this.  Any webserver that can serve static content can do this.  For example, if you have PHP installed, you can use its baked in server like this:\n\n```\ncd output\nphp -S 0.0.0.0:8888\n```\n\nThen it becomes available on http://localhost:8888\n\nOf course, any web server will work -- you can install NGINX and put the output files in your webroot for instance.\n\n\n### Warning: Spacing Fussiness\n\nPython's markdown library is fussier than Docsify's when it comes to spacing.  Generally, if your markdown isn't converting correctly, it's one of two problems; either you need a blank line before the line that is breaking, or you need to make sure your indentation is exactly 2 spaces.\n\nFor instance, this:\n\n```\n## Header text\n- Some List\n- Like this\n- More elements\n```\n\nWill render the list items inline with the header text.  You need a blank line above the list:\n\n```\n## Header text\n\n- Some List\n- Like this\n- More elements\n```\n\nOr, the other example, spacing.  This will render correctly in Docsify, but will show up as a block-quote in the compiled HTML version:\n\n```\n  - This\n  - List\n  - Doesn't\n  - Need\n  - Spaces\n```\n\nIt should simply be:\n\n```\n- This\n- List\n- Doesn't\n- Need\n- Spaces\n```\n\nYou can get odd results if you nest lists incorrectly, like:\n\n```\n- This is a\n- List\n   - This one is nested\n   - But it has 3 spaces instead of 4, so it will\n   - show up in docsify but not python\n```\n\nThis should be like this instead:\n\n```\n- This is a\n- List\n  - This one is nested\n  - But it has 3 spaces instead of 4, so it will\n  - show up in docsify but not python\n```\n\n... with just 2 spaces before the nested list items.  It is almost always one of these problems if you have a rendering issue, so check your spaces and make sure you have blank lines before new block elements.\n\n### Tabs Functionality\n\nPlease see the [docsify-tabs](https://jhildenbiddle.github.io/docsify-tabs/#/) ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdatacoves%2Fdocs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdatacoves%2Fdocs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdatacoves%2Fdocs/lists"}