{"id":28408706,"url":"https://github.com/sourcelevel/guidelines","last_synced_at":"2026-02-09T14:32:02.368Z","repository":{"id":44336618,"uuid":"192600535","full_name":"sourcelevel/guidelines","owner":"sourcelevel","description":"How we communicate :ant:","archived":false,"fork":false,"pushed_at":"2021-09-21T18:41:01.000Z","size":103,"stargazers_count":12,"open_issues_count":0,"forks_count":3,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-06-30T02:39:02.594Z","etag":null,"topics":["code-review","communication","git-workflow","guidelines","guides"],"latest_commit_sha":null,"homepage":null,"language":null,"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/sourcelevel.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-06-18T19:28:20.000Z","updated_at":"2024-07-27T06:36:06.000Z","dependencies_parsed_at":"2022-08-31T14:22:04.250Z","dependency_job_id":null,"html_url":"https://github.com/sourcelevel/guidelines","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/sourcelevel/guidelines","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sourcelevel%2Fguidelines","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sourcelevel%2Fguidelines/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sourcelevel%2Fguidelines/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sourcelevel%2Fguidelines/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sourcelevel","download_url":"https://codeload.github.com/sourcelevel/guidelines/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sourcelevel%2Fguidelines/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268294110,"owners_count":24227614,"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-01T02:00:08.611Z","response_time":67,"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":["code-review","communication","git-workflow","guidelines","guides"],"created_at":"2025-06-02T04:09:48.407Z","updated_at":"2026-02-09T14:32:00.423Z","avatar_url":"https://github.com/sourcelevel.png","language":null,"readme":"SourceLevel - Guidelines\n======================\n\nThis repository was created to document our guidelines and styleguides maintaining our apps.\n\nAs [Hugo Giraudel](http://hugogiraudel.com/) states in [Sass Guidelines](https://sass-guidelin.es/#introduction):\n\n\u003e A styleguide is not just a pleasing document to read, picturing an ideal state for your code. It is a key document in a project’s life, describing how and why code should be written. It may look like overkill for small projects, but it helps a lot in keeping the codebase clean, scalable and easily maintainable.\n\u003e\n\u003e Needless to say, the more developers involved on a project, the more code guidelines are needed. Along the same lines, the bigger the project, the more a styleguide is a must.\n\nAnd Harry Roberts from [CSS Guidelines](http://cssguidelin.es/#the-importance-of-a-styleguide):\n\n\u003e A coding styleguide (note, not a visual styleguide) is a valuable tool for teams who:\n\u003e * build and maintain products for a reasonable length of time;\n\u003e * have developers of differing abilities and specialisms;\n\u003e * have a number of different developers working on a product at any given time;\n\u003e * on-board new staff regularly;\n\u003e * have a number of codebases that developers dip in and out of.\n\nOur purpose is to define a standard way to write code in a clear and semantic form. We care a lot with code legibility and always worried if other developers will understand easily what we're doing and how we're thinking about code..\n\nThe entire team should contribute with this repo, giving suggestions and making changes on it. Welcome!\n\nFirst-timer? We recommend start reading `General/Editor` and then `Process Workflow` :)\n\n## Our Coding Styleguide\n\nInstead of creating a specific coding styleguide for each programming language/tool that we use, we've have decided to just use linters configuration files to indicate which patterns we follow. All linters configuration files can be found in a single repository at [sourcelevel/linters](https://github.com/sourcelevel/linters).\n\n## Our Guidelines\n\n*   [General/Editor](https://github.com/sourcelevel/guidelines/blob/master/resources/general.md)\n*   [Commit Messages](https://github.com/sourcelevel/guidelines/blob/master/resources/commit_messages.md)\n*   [Pull Requests](https://github.com/sourcelevel/guidelines/blob/master/resources/pull_requests.md)\n*   [Process Workflow](https://github.com/sourcelevel/guidelines/blob/master/resources/process_workflow.md)\n*   [Git Workflow](https://github.com/sourcelevel/guidelines/blob/master/resources/git_workflow.md)\n\n## References\n\n*   [Plataformatec](http://guidelines.plataformatec.com.br/)\n*   [CSS Guidelines](http://cssguidelin.es/)\n*   [Sass Guidelines](https://sass-guidelin.es)\n*   [Idiomatic CSS](https://github.com/necolas/idiomatic-css)\n*   [CSS-Tricks - Sass Style Guide](https://css-tricks.com/sass-style-guide/)\n*   [Mark Otto - Code Guide](https://github.com/mdo/code-guide)\n*   [Future Friendly Style Guides](https://speakerdeck.com/lukebrooker/future-friendly-style-guides)\n*   [Styleguides Examples](http://styleguides.io/examples)\n\n## TODO\n\n* Detail how to maintain this guide\n* Find a better tool to draw concept/branch node map\n","funding_links":[],"categories":["📦 Legacy \u0026 Inactive Projects"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsourcelevel%2Fguidelines","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsourcelevel%2Fguidelines","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsourcelevel%2Fguidelines/lists"}