{"id":40752487,"url":"https://github.com/flexiblepower/s2-documentation","last_synced_at":"2026-01-21T16:06:03.891Z","repository":{"id":283088847,"uuid":"950627414","full_name":"flexiblepower/s2-documentation","owner":"flexiblepower","description":"Documentation for the S2 standard","archived":false,"fork":false,"pushed_at":"2026-01-12T10:10:24.000Z","size":2986,"stargazers_count":4,"open_issues_count":7,"forks_count":3,"subscribers_count":6,"default_branch":"main","last_synced_at":"2026-01-12T18:31:18.116Z","etag":null,"topics":["docs","energy-flexibility","s2"],"latest_commit_sha":null,"homepage":"https://docs.s2standard.org/","language":"Rust","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/flexiblepower.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-03-18T13:01:10.000Z","updated_at":"2026-01-12T08:53:14.000Z","dependencies_parsed_at":"2025-03-18T14:37:15.228Z","dependency_job_id":"05c64226-6178-415a-a11e-2e7e298e3f30","html_url":"https://github.com/flexiblepower/s2-documentation","commit_stats":null,"previous_names":["flexiblepower/s2-documentation"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/flexiblepower/s2-documentation","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flexiblepower%2Fs2-documentation","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flexiblepower%2Fs2-documentation/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flexiblepower%2Fs2-documentation/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flexiblepower%2Fs2-documentation/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/flexiblepower","download_url":"https://codeload.github.com/flexiblepower/s2-documentation/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flexiblepower%2Fs2-documentation/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28635927,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-21T15:01:31.228Z","status":"ssl_error","status_checked_at":"2026-01-21T14:42:58.942Z","response_time":86,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["docs","energy-flexibility","s2"],"created_at":"2026-01-21T16:06:03.838Z","updated_at":"2026-01-21T16:06:03.886Z","avatar_url":"https://github.com/flexiblepower.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Documentation for the S2 standard\n\u003cdiv align=\"center\"\u003e\n    \u003ca href=\"https://s2standard.org\"\u003e\u003cimg src=\"./Logo-S2.svg\" width=\"200\" height=\"200\" /\u003e\u003c/a\u003e\n\u003c/div\u003e\n\u003cbr /\u003e\n\nSee the live version at [docs.s2standard.org](https://docs.s2standard.org).\n\nThis repository contains the source code for the documentation website of the S2 standard. Additionally, it includes the structured documentation from which the data model reference is generated. \n\n\u003e The structured documentation serves as the single source of truth for other places where the data model is documented, such as in the S2-Rust library.\n\n\n## Workflow\n\n### Generate structure documentation (one time action)\nFor the initial generation of the structured documentation, the `structured-documentation-generator` has been used. This is a one time action, i.e. the structured documentation has been generated once, and should not be regenerated again. The data model for the structured documentation is contained in [`structured-documentation-generator/src/doc_types.rs`](structured-documentation-generator/src/doc_types.rs). The result has been put in the `structured-documentation` folder.\n\n### Document the data model\nThe generated structured documentation from the previous step is the starting point for the documentation of the data model. The documentation has to be extended manually.\n\n### Generate Markdown for data model reference\nThe data model reference is created directly from the structured-documentation. Since Docusaurus allows for Markdown-based documentation, the `website-generator` takes the structured documentation and generates Markdown files for them, which are placed in `website/model-reference`. Please note that this folder is added to `.gitignore` because the Markdown files will be freshly created during the deployment. \n\n### Write documentation for S2\nThe `website` directory contains the file that make up the actual documentation website. Please find in the `website/docs` directory all the Markdown files that constitute the documentation of the S2 standard. The convention is to follow pretty URL patterns (i.e. kebab-case) for the directories and filenames because Docusaurus uses those names to create URLs to the pages (and we want pretty URLs, of course).\n\n### Running the documentation development server\nDocusaurus comes with a development server with hot-code replacement. To build the documentation website and to run the development server locally, make sure to have nodejs (v. 18 and higher) installed, and run from the `website` directory:\n\n```\nnpm run start\n```\n\nSometimes it is needed to clear the build cache in case there are errors displayed on the development website:\n\n```\nnpm run clear\n```\n\n\n### Deployment\nThe documentation website is deployed to GitHub pages with GitHub actions. Every time a branch is merged to master, the website is automatically deployed 🚀\n\n## Technical details\nThe documentation website is created by means of [docusaurus.io](https://docusaurus.io/), that leverages React to create powerful websites but also allows for easy-to-write Markdown-based documentation. \"This project uses the default styling theme of Docusaurus that uses [infima](https://infima.dev/). So if you want to style something on the main page, please refer to the infima docs.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflexiblepower%2Fs2-documentation","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fflexiblepower%2Fs2-documentation","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflexiblepower%2Fs2-documentation/lists"}