{"id":18636670,"url":"https://github.com/localstack/snowflake-docs","last_synced_at":"2025-11-04T14:30:23.306Z","repository":{"id":254135168,"uuid":"761190281","full_name":"localstack/snowflake-docs","owner":"localstack","description":"Private repo for LocalStack's Snowflake emulator docs","archived":false,"fork":false,"pushed_at":"2024-09-17T11:08:20.000Z","size":5116,"stargazers_count":3,"open_issues_count":1,"forks_count":0,"subscribers_count":12,"default_branch":"main","last_synced_at":"2024-09-18T08:16:12.191Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://snowflake.localstack.cloud/introduction/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/localstack.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2024-02-21T12:12:03.000Z","updated_at":"2024-09-17T11:06:17.000Z","dependencies_parsed_at":"2024-09-08T01:24:33.529Z","dependency_job_id":"132b02f9-e8a5-4e4d-85ae-7dce5734d04e","html_url":"https://github.com/localstack/snowflake-docs","commit_stats":null,"previous_names":["localstack/snowflake-docs"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/localstack%2Fsnowflake-docs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/localstack%2Fsnowflake-docs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/localstack%2Fsnowflake-docs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/localstack%2Fsnowflake-docs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/localstack","download_url":"https://codeload.github.com/localstack/snowflake-docs/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239433908,"owners_count":19637806,"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","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":[],"created_at":"2024-11-07T05:31:05.015Z","updated_at":"2025-11-04T14:30:23.207Z","avatar_url":"https://github.com/localstack.png","language":"HTML","readme":"LocalStack Docs\n=====================\n\nRepository for [docs.localstack.cloud](https://docs.localstack.cloud).\n\n\nGetting Started\n-----------\n\n### Basics\nLocalStack Docs is using the following technology stack:\n- [Hugo](https://gohugo.io) to generate the static site.\n- [Docsy](https://docsy.dev) as a theme for Hugo.\n- [GitHub Pages](https://pages.github.com/) to automatically deploy every commit on the `main` branch of this repository on [docs.localstack.cloud](https://docs.localstack.cloud).\n\n\n### Clone the repo\nClone this repository and initialize the Git submodules recursively (`themes/docsy` is a submodule that again has submodules for vendored assets like fontawesome).\n\n    git clone --recurse-submodules --depth 1 git@github.com:localstack/docs.git\n\nThis performs a shallow clone, which leads to only the main branch being configured for your remote.\nTo be able to pull/push from/to all branches, please run:\n\n    git config remote.origin.fetch \"+refs/heads/*:refs/remotes/origin/*\" \u0026\u0026 git fetch\n\nor:\n\n    git clone git@github.com:localstack/docs.git\n    cd docs\n    git submodule update --init --recursive\n\n### Install Hugo\nLocalStack Docs is based on the [Hugo static site generator](https://gohugo.io).\n\nIn order to contribute to LocalStack Docs, you need to [install Hugo](https://gohugo.io/getting-started/installing) in order to verify your changes. Make sure to install the _extended_ version of Hugo.\nYou also need to make sure that `go` is installed in order to run hugo scripts. \n\n### Run locally\nOnce you have Hugo installed, you can start your local server with the following command:\n\n    hugo serve\n\nor run in developer mode with automatic reload:\n\n    hugo serve --watch=true --disableFastRender -D\n\nOnce the server is started, the locally served Docs are available at http://localhost:1313.\n\n### Writing content\nThe whole site is generated with Hugo, a powerful static-site generator.\n\nYou can find an extensive documentation on how to use Hugo [in their docs](https://gohugo.io/documentation/), however most of the content is written in plain Markdown.\n\nMake sure to follow the best practices below when contributing content.\n\n#### Updating developer hub applications\nWhile contributing to the developer hub applications page i.e. editing `data/developerhub/applications.json` file, make sure to run the `create-applications.js` script in the `scripts` folder to create new application pages.\n\nExample usage in the project root:\n\n    node scripts/create-applications.js\n\n## Best Practices\n\nPlease follow these best practices when writing documentation in this repository:\n- Use the custom `command` shortcode for all one-liner commands (also when their output is presented). Do not use it for bash scripts with comments. You can find a more detailed description here: https://github.com/localstack/docs/pull/55\n- Use the [`ref` or `relref` shortcode](https://gohugo.io/content-management/cross-references/#use-ref-and-relref) when creating non-external links (but still use the markdown native image linking, ref doesn't work there).\n  You can either use `ref` or `relref`, the point is to have compile time internal-link checks (which works for both).\n- Stick to markdown if possible.\n- Use one line for each sentence in markdown.\n  If you don't add a backslash at the end of the line or add two new-lines, there won't be linebreak in the rendered text.\n- For snippets, define the correct syntax highlighting.\n  Here's a list of the supported languages:\n  https://gohugo.io/content-management/syntax-highlighting/\n- If you want to highlight a specific line, there's a feature for that: https://gohugo.io/content-management/syntax-highlighting/#highlighting-in-code-fences\n  - This is also supported by the `command` shortcode!\n- Handling images can be a bit tedious with Hugo.\n  If you want to use images in your post, create a new [leaf bundle directory](https://github.com/gohugoio/hugo/issues/1240) and put the image and the post (named `index.md`) in there (you can find examples in the docs already, f.e. the cognito service docs).\n\n  Then you can use the usual markdown syntax with a relative path (f.e.:\n  `![Alternative_Text](file_next_to_post.png)`).\n\n  If you want to resize the image, use the `figure` or `img` shortcode. For example:\n  `{{\u003c img src=\"cockpit-init-check.png\" class=\"img-fluid shadow rounded\" width=\"150px\" \u003e}}`\n\nPS.: Feel free to add more best practices here.\n\n## Troubleshooting\nThis section covers common issues when working with LocalStack Docs:\n\n### Missing shortcodes\nExample error:\n```\nStart building sites …\nhugo v0.88.1-5BC54738+extended linux/amd64 BuildDate=2021-09-04T09:39:19Z VendorInfo=gohugoio\nError: Error building site: \"/home/localstack/Repos/docs-test/content/en/get-started/_index.md:57:1\": failed to extract shortcode: template for shortcode \"alert\" not found\nBuilt in 45 ms\n```\n\n1. Make sure to correctly clone and initialize the git submodules of this repo. For details see the section \"[Clone the repo](#clone-the-repo)\" above.\n2. Delete the Hugo Module cache using `hugo mod clean` or `make clean`.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flocalstack%2Fsnowflake-docs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flocalstack%2Fsnowflake-docs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flocalstack%2Fsnowflake-docs/lists"}