{"id":24811127,"url":"https://github.com/thin-edge/tedge-docs","last_synced_at":"2025-10-13T12:31:45.274Z","repository":{"id":177629110,"uuid":"648605487","full_name":"thin-edge/tedge-docs","owner":"thin-edge","description":"Thin-edge documentation","archived":false,"fork":false,"pushed_at":"2025-01-14T18:14:40.000Z","size":23456,"stargazers_count":0,"open_issues_count":0,"forks_count":6,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-01-14T19:55:23.975Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://thin-edge.github.io/thin-edge.io/","language":"JavaScript","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/thin-edge.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":"2023-06-02T11:11:53.000Z","updated_at":"2025-01-14T18:14:42.000Z","dependencies_parsed_at":"2023-12-21T01:03:37.600Z","dependency_job_id":"1c7c3a93-9432-49c1-96cc-a62379b98f0a","html_url":"https://github.com/thin-edge/tedge-docs","commit_stats":null,"previous_names":["thin-edge/tedge-docs"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thin-edge%2Ftedge-docs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thin-edge%2Ftedge-docs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thin-edge%2Ftedge-docs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thin-edge%2Ftedge-docs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thin-edge","download_url":"https://codeload.github.com/thin-edge/tedge-docs/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":236345829,"owners_count":19134343,"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":"2025-01-30T12:19:26.651Z","updated_at":"2025-10-13T12:31:36.836Z","avatar_url":"https://github.com/thin-edge.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Thin-edge documentation\n\nThis repository contains [Docusaurus 2](https://docusaurus.io/) configuration files\nfor generating the documentation of [thin-edge](https://github.com/thin-edge/thin-edge.io).\n\n\nThe documentation source files are stored in the [main thin-edge.io](https://github.com/thin-edge/thin-edge.io/tree/main/docs/src) repository.\n\nCheck out the [online documentation](https://thin-edge.github.io/thin-edge.io) to see how the docs looked when published by Docusaurus.\n\n## Running docs in development\n\n**Pre-requisites**\n\n* [Node.js](https://nodejs.org/en) \u003e= 20.x\n\nThe instructions below detail how to build and serve the documentation.\n\n1. Clone the project and change directory to the project\n\n    ```sh\n    git clone https://github.com/thin-edge/tedge-docs\n    cd tedge-docs\n    ```\n\n2. Enable Node.js corepack\n\n    ```sh\n    corepack enable\n    ```\n\n    If corepack is not installed, then you will have to install it using the following:\n\n    ```sh\n    npm install -g corepack\n    ```\n\n3. Checkout the thin-edge.io source markdown files\n\n    ```sh\n    just init\n\n    # Optional (if you want to include the last official docs as well)\n    just checkout-version \"\u003ctag\u003e\"\n    ```\n\n    You can also checkout a fork instead (rather than the main project) by providing the git url of the fork as the first positional argument.\n\n    ```sh\n    just project=https://github.com/myuser/thin-edge.io.git init\n    ```\n\n4. Start the documentation (using a local dev server)\n\n    ```sh\n    just docs\n    ```\n\n    Alternatively you can start the docs\n\n    ```sh\n    just docs-container\n    ```\n\n    **Note**\n\n    * The thin-edge.io repo be cloned automatically in a sibling folder (on the same level as the `tedge-docs` project)\n\n5. You can now edit the thin-edge.io documents under the `docs/src` folder of the `thin-edge.io` repository. Any changes will be detected and the browser page will be refreshed automatically.\n\n## Checkout a branch and treat it as a specific version\n\nTo support use-cases where the documentation has been fixed after a tag has been created, the following command allows you to checkout a specific branch and treat it like the given version.\n\nThe following will checkout the `main` branch and treat it as the `0.11.0` version.\n\n```sh\njust checkout-version 0.11.0 main\n```\n\nOnce you have done this, then you can commit the files to the project.\n\n## Building the docs\n\nAssuming you have done the initial project setup in the [running docs in development](./README.md#running-docs-in-development) section, then you can build the production files using the following steps:\n\nThese instructions will produce a static web-site in the `build/` folder at the root project directory.\n\n### Natively (if you have nodejs installed on your machine/dev container)\n\n```sh\njust build\n```\n\nThen verify the result by serving the files:\n\n### Container\n\n```sh\njust docs-container yarn build\n```\n\nThen verify the result by serving the files:\n\n```sh\njust docs-container yarn serve\n```\n\n## Community Plugin Documentation\n\nThe docs also maintain a custom (React) component to display the list of Community Plugins in an interactive way, to make it easier for users to search for plugins which interest them. Each plugin includes a short description, and links to the repository code and the installable package (if applicable).The same plugin list will be visible in all displayed documentation version to increase their visibility to users.\n\n### Add or edit a plugin\n\nThe list of plugins is sourced via a single [typescript file](./src/data/plugins.tsx) which makes it easier to maintain and keep consistent across all plugins.\n\nTo add or edit a plugin use the following procedure:\n\n1. Fork the repo\n2. Create a new branch with a name relevant to your change\n3. Edit the [typescript file](./src/data/plugins.tsx) file and add the plugin to the array\n\n    **Notes**\n\n    * Add any relevant *tags* to the plugins to allow searching for the plugins based on a fixed list of keywords.\n\n4. Create a PR against the `main` branch of the upstream repository\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthin-edge%2Ftedge-docs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthin-edge%2Ftedge-docs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthin-edge%2Ftedge-docs/lists"}