{"id":30201499,"url":"https://github.com/esipfed/esds-community-guide","last_synced_at":"2025-10-08T10:39:24.250Z","repository":{"id":45882298,"uuid":"339448086","full_name":"ESIPFed/esds-community-guide","owner":"ESIPFed","description":"We aim to develop actionable tools and best practices that help new and existing open source projects make progress within the NASA Earth Science community.","archived":false,"fork":false,"pushed_at":"2024-03-26T16:21:44.000Z","size":2631,"stargazers_count":2,"open_issues_count":0,"forks_count":6,"subscribers_count":9,"default_branch":"main","last_synced_at":"2025-08-13T10:51:32.497Z","etag":null,"topics":["community","earth","nasa","ope-science","open-source","science"],"latest_commit_sha":null,"homepage":"https://esipfed.github.io/esds-community-guide/","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/ESIPFed.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"docs/CODE_OF_CONDUCT.md","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}},"created_at":"2021-02-16T15:48:05.000Z","updated_at":"2024-08-09T20:02:22.000Z","dependencies_parsed_at":"2023-11-24T09:05:48.032Z","dependency_job_id":"268179c5-3476-4b68-8e41-0993b4d83bd4","html_url":"https://github.com/ESIPFed/esds-community-guide","commit_stats":{"total_commits":21,"total_committers":7,"mean_commits":3.0,"dds":0.6190476190476191,"last_synced_commit":"1e3bf04ff164c6d78680b292025cdef969902c2d"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ESIPFed/esds-community-guide","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ESIPFed%2Fesds-community-guide","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ESIPFed%2Fesds-community-guide/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ESIPFed%2Fesds-community-guide/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ESIPFed%2Fesds-community-guide/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ESIPFed","download_url":"https://codeload.github.com/ESIPFed/esds-community-guide/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ESIPFed%2Fesds-community-guide/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278931653,"owners_count":26070788,"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-10-08T02:00:06.501Z","response_time":56,"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":["community","earth","nasa","ope-science","open-source","science"],"created_at":"2025-08-13T10:50:18.835Z","updated_at":"2025-10-08T10:39:19.242Z","avatar_url":"https://github.com/ESIPFed.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# ESDS Community Development Best Practices\n\nThe NASA ESDS Community Development Best Practices Working Group (CDBP) aims to\ndevelop actionable tools and best practices that help new and existing open \nsource projects make progress within the NASA Earth Science community.\n\nSee our guide at \u003chttps://ESIPFed.github.io/esds-community-guide/\u003e\n\n# Contributing to the guide\n\nThe ESDS community guide built using [MkDocs](https://www.mkdocs.org/) and the\n[Material theme](https://squidfunk.github.io/mkdocs-material/). \n\n## How to\n\n### Setting up a development environment\n\nIn order to easily manage dependencies, we recommend using dedicated project environments\nvia [Anaconda/Miniconda](https://docs.conda.io/projects/conda/en/latest/user-guide/install/index.html).\nor [Python virtual environments](https://docs.python.org/3/tutorial/venv.html).\n\nOnce your environment is created, you can install the required dependencies with\n```shell\npython -m pip install -r requirements.txt\n```\n\n### Build and view the guide\n\nWith your development environment activated, run\n\n```shell\nmkdocs serve\n```\n\nto generate the guide. This will allow you to view it at \u003chttp://127.0.0.1:8000/\u003e.\nMkDocs will automatically watch for new/changed files in this directory and\nrebuild the website for a live preview of your changes (just refresh the webpage!).\n\n*Note: `mkdocs serve` captures your terminal; use `crtl+c` to exit. It is recommended you\nuse a second/dedicated terminal so that you can keep this command running.*\n\n### Deploy\n\nThis guide is deployed to [GitHub Pages](https://pages.github.com/) at\n\u003chttps://ESIPFed.github.io/esds-community-guide/\u003e. The website is served out of the \nspecial `gh-pages` branch of this repository and deployment is handled automatically \nwith the [`deploy_to_github_io.yml`](.github/workflows/deploy_to_github_io.yml) \nGithub Action for any merge to `main`.\n\n## Markdown formatting\n\nThe way MkDocs and GitHub parse markdown documents is slightly different. Some compatibility tips:\n\n* Raw links should be wrapped in carrots: `\u003chttps://example.com\u003e`\n* MkDocs is pickier about whitespace between types (e.g., headers, paragraphs, lists) and seems to \nexpect indents to be 4 spaces. So to get a representation like:\n\n    \u003chr/\u003e\n    \n    - A list item\n    \n         ##### A sub list heading\n        - A sub-list item\n    \n    \u003chr/\u003e\n      \n    in MkDocs, you'll want to write it like: \n        \n    ### Good\n    ```markdown\n    - A list item\n    \n        ##### A sub list heading\n        - A sub-list item\n    ```\n    \n    ### Bad\n    ```markdown\n    - A list item\n      ##### A sub list heading\n      - A sub-list item\n    ```\n    \n    ```markdown\n    - A list item\n        ##### A sub list heading\n        - A sub-list item\n    ```\n    \n    ```markdown\n    - A list item\n    \n      ##### A sub list heading\n      - A sub-list item\n    ```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fesipfed%2Fesds-community-guide","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fesipfed%2Fesds-community-guide","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fesipfed%2Fesds-community-guide/lists"}