{"id":44419245,"url":"https://github.com/trento-project/docs","last_synced_at":"2026-02-12T09:09:39.501Z","repository":{"id":63190005,"uuid":"564680433","full_name":"trento-project/docs","owner":"trento-project","description":"Trento project documentation repository","archived":false,"fork":false,"pushed_at":"2026-02-05T15:24:32.000Z","size":4648,"stargazers_count":4,"open_issues_count":2,"forks_count":3,"subscribers_count":6,"default_branch":"main","last_synced_at":"2026-02-05T19:44:49.901Z","etag":null,"topics":["best-practices","coding-standards","docs","templates"],"latest_commit_sha":null,"homepage":"https://trento-project.io/docs","language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/trento-project.png","metadata":{"files":{"readme":"README.adoc","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":"2022-11-11T08:43:27.000Z","updated_at":"2026-02-05T15:36:16.000Z","dependencies_parsed_at":"2026-01-28T19:20:39.376Z","dependency_job_id":null,"html_url":"https://github.com/trento-project/docs","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/trento-project/docs","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trento-project%2Fdocs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trento-project%2Fdocs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trento-project%2Fdocs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trento-project%2Fdocs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/trento-project","download_url":"https://codeload.github.com/trento-project/docs/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trento-project%2Fdocs/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29362246,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-12T08:51:36.827Z","status":"ssl_error","status_checked_at":"2026-02-12T08:51:26.849Z","response_time":55,"last_error":"SSL_read: 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":["best-practices","coding-standards","docs","templates"],"created_at":"2026-02-12T09:09:38.632Z","updated_at":"2026-02-12T09:09:39.496Z","avatar_url":"https://github.com/trento-project.png","language":"CSS","readme":"= Developer Documentation\nifndef::site-gen-antora[:relfileprefix: /content/]\n\nThis repository contains the Trento project documentation that does not interest a specific service, such as ADR, coding standards and best practices, CI workflows, and templates. The link:https://github.com/trento-project/docs/tree/main/content[*content* directory] is the home of these sources.\n \n* xref:architecture/trento-architecture.adoc[Architecture]\n* xref:architecture/adr/README.adoc[Architecture Decision Records (ADR)]\n* xref:coding-standards/README.adoc[Coding standards]\n* link:https://github.com/trento-project/docs/tree/main/content/rfc[Request for Comments (RFC)]\n* link:https://github.com/trento-project/docs/tree/main/content/internal-notes[Internal Notes]\n* link:https://github.com/trento-project/docs/tree/main/content/templates[Templates]\n\n== Trento docs site\n\nThe `trento-docs-site` directory builds the link:https://www.trento-project.io/docs/[Trento project’s unified documentation site] using https://antora.org/[Antora]. Learn more about xref:trento-docs-site/README.adoc[the documentation hub here].\n\n\n== Trento docs site ui\n\nThe `trento-docs-site-ui` directory is used to customize and design the layout of the link:https://www.trento-project.io/docs/[Trento docs site]. Learn more about the xref:trento-docs-site-ui/README.adoc[ui customization here].\n\n== Trento docs hub preview\n\nFrom the repository root, build the docs site and serve it on port 3000:\n\n[source,bash]\n----\ndocker compose up trento-docs\n----\n\nOpen http://localhost:3000 while the command is running.\n\nThe generated HTML is in `trento-docs-site/build/trento-docs-site-public`.\n\n== Official SUSE documentation preview\n\nFrom the repository root, build the DocBook HTML in a container and serve it on port 3001:\n\n[source,bash]\n----\ndocker compose up daps-serve\n----\n\nOpen http://localhost:3001 while the command is running.\n\nThe generated HTML is in `trento/build/SLES-SAP-trento/html/SLES-SAP-trento`.\nEach run clears `trento/build/SLES-SAP-trento` before rebuilding to avoid stale files.\n\n== Combined preview (Antora + DocBook)\n\nStart both preview servers with one command:\n\n[source,bash]\n----\ndocker compose up\n----\n\n== Dev docs environment without logs\n\nStart all services in the background and skip compose logs:\n\n[source,bash]\n----\nsudo bash dev-docs-env.sh\n----\n\nOnce it finishes, open:\n\n* http://localhost:3000 (Trento docs hub)\n* http://localhost:3001 (SUSE HTML build)\n* http://localhost:3002/SLES-SAP-trento_en.pdf (SUSE PDF build)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftrento-project%2Fdocs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftrento-project%2Fdocs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftrento-project%2Fdocs/lists"}