{"id":28254728,"url":"https://github.com/practicalli/i-devangelist","last_synced_at":"2025-06-16T04:31:04.694Z","repository":{"id":293066114,"uuid":"982291096","full_name":"practicalli/i-devangelist","owner":"practicalli","description":null,"archived":false,"fork":false,"pushed_at":"2025-05-13T13:32:23.000Z","size":1381,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-25T10:43:06.589Z","etag":null,"topics":["community-building","developer-advocacy","developer-advocates","developer-evangelism","developer-relations"],"latest_commit_sha":null,"homepage":"https://practical.li/i-devangelist/","language":"Makefile","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/practicalli.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":["practicalli-johnny"]}},"created_at":"2025-05-12T16:54:15.000Z","updated_at":"2025-05-13T13:30:37.000Z","dependencies_parsed_at":"2025-05-13T14:52:20.647Z","dependency_job_id":"49a9258f-4bd2-430b-ba34-bdf2981120f5","html_url":"https://github.com/practicalli/i-devangelist","commit_stats":null,"previous_names":["practicalli/i-devangelist"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/practicalli/i-devangelist","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/practicalli%2Fi-devangelist","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/practicalli%2Fi-devangelist/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/practicalli%2Fi-devangelist/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/practicalli%2Fi-devangelist/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/practicalli","download_url":"https://codeload.github.com/practicalli/i-devangelist/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/practicalli%2Fi-devangelist/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260096618,"owners_count":22958083,"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":["community-building","developer-advocacy","developer-advocates","developer-evangelism","developer-relations"],"created_at":"2025-05-19T20:15:25.845Z","updated_at":"2025-06-16T04:31:04.674Z","avatar_url":"https://github.com/practicalli.png","language":"Makefile","funding_links":["https://github.com/sponsors/practicalli-johnny","https://github.com/sponsors/practicalli-johnny/"],"categories":[],"sub_categories":[],"readme":"# I, Devangelist\n\nA journey into developer advocacy and community development.\n\nThe life and times of a developer evangelist can be fun, enlightening and highly intense. A career can also be full of the unexpected, not all of which is positive.\n\nI, Devangelist presents stories from a variety of experiences that highlight the huge variety of tasks involved in the role (and how much the role can change from company to company)\n\nThere are practical guides to navigate through the role effectively.\n\nThis site will also contain lots of tips and suggestions for those currently in this role, gathered from a range of experiences of Developer Evangelists / Advocates and Community managers across the world.\n\n\n\n```none\n██████╗ ██████╗  █████╗  ██████╗████████╗██╗ ██████╗ █████╗ ██╗     ██╗     ██╗\n██╔══██╗██╔══██╗██╔══██╗██╔════╝╚══██╔══╝██║██╔════╝██╔══██╗██║     ██║     ██║\n██████╔╝██████╔╝███████║██║        ██║   ██║██║     ███████║██║     ██║     ██║\n██╔═══╝ ██╔══██╗██╔══██║██║        ██║   ██║██║     ██╔══██║██║     ██║     ██║\n██║     ██║  ██║██║  ██║╚██████╗   ██║   ██║╚██████╗██║  ██║███████╗███████╗██║\n╚═╝     ╚═╝  ╚═╝╚═╝  ╚═╝ ╚═════╝   ╚═╝   ╚═╝ ╚═════╝╚═╝  ╚═╝╚══════╝╚══════╝╚═╝\n```\n\n## Sponsor Practicalli\n\n[![Sponsor Practicalli via GitHub](https://raw.githubusercontent.com/practicalli/graphic-design/live/buttons/practicalli-github-sponsors-button.png)](https://github.com/sponsors/practicalli-johnny/)\n\nAll sponsorship funds are used to support the continued development of [Practicalli series of books and videos](https://practical.li/), although most work is done at personal cost and time.\n\nThanks to [Cognitect](https://www.cognitect.com/), [Nubank](https://nubank.com.br/) and a wide range of other [sponsors](https://github.com/sponsors/practicalli-johnny#sponsors) for your continued support\n\n## Contributing\n\nContributions are most welcome for Practicalli Books and project.  However, as this is a personal journal, this specific repository does not take pull requests.\n\nPlease read the [detailed Practicalli contributing page](https://practical.li/contributing/) to help you to help Practicalli.\n\n\n## GitHub Actions\n\nThe megalinter GitHub actions will run when a pull request is created,checking basic markdown syntax.\n\nA review of the change will be carried out by the Practicalli team and the PR merged if the change is acceptable.\n\nThe Publish Book GitHub action will run when PR's are merged into main (or the Practicalli team pushes changes to the default branch).\n\nPublish book workflow installs Material for MkDocs version 9\n\n\n## Local development\n\nInstall the Python3 Pip package manager using the Debian package manager:\n\n```shell\napt install python3-pip pipx\n```\n\nCreate and activate a python virtual environment\n\n```shell\npython -m venv ~/venv/ \u0026\u0026 source ~/venv/bin/activate\n```\n\nUse pip3 to install mkdocs-material, along with the plugins used by the Practicalli site (plugins are also installed in the GitHub Action workflow)\n\n```shell\npip3 install mkdocs-material mkdocs-callouts mkdocs-glightbox mkdocs-git-revision-date-localized-plugin mkdocs-redirects mkdocs-rss-plugin pillow cairosvg\n```\n\n\u003e pillow and cairosvg python packages are required for [Social Cards](https://squidfunk.github.io/mkdocs-material/setup/setting-up-social-cards/)\n\n\nMacOSX has not been tested, although it is assumed homebrew approach is the most likely to work.\n\n```shell\nbrew install python@3.12\n```\n\n---\n\nFork the GitHub repository and clone that fork to your computer,\n\n```shell\ngit clone https://github.com/\u003cyour-github-account\u003e/\u003crepository\u003e.git\n```\n\nRun a local server from the root of the cloned project\n\n```shell\nmake docs\n```\n\nThe website will open at \u003chttp://localhost:8000\u003e\n\nIf making smaller changes, then only rebuild the content that changes, speeding up the local development process\n\n```shell\nmake docs-changed\n```\n\n\u003e NOTE: navigation changes may not be correctly reflected without reloading the page in the web browser or carrying out a full `make docs` build\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpracticalli%2Fi-devangelist","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpracticalli%2Fi-devangelist","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpracticalli%2Fi-devangelist/lists"}