65 Commits

Author SHA1 Message Date
Rabenherz112
ad5f5aa811 doc: update links to awesome-syadmin (#1153) 2025-02-19 22:46:38 +00:00
nodiscc
560a11666a PULL_REQUEST_TEMPLATE.md: clarify demo credentials requirements (#1105) 2025-01-19 19:29:56 +00:00
Loymdayddaud
809ade2456 doc: Update addition issue template (#1040)
Use the "reviewers wanted" label by default and fix an extraneous word.
2024-12-29 18:07:47 +00:00
kokomo123
2986dcc22c github actions: update checkout actions to v4 (#870) 2024-09-24 23:03:17 +00:00
nodiscc
ae761efc89 doc: issue template: cleanup/don't repeat contributing.md (#739)
Detailed guidelines about sentence formats, fork information, etc. are already listed at https://github.com/awesome-selfhosted/awesome-selfhosted-data/blob/master/CONTRIBUTING.md#other-guidelines
2024-06-07 17:56:05 +00:00
nodiscc
66bd6d7e35 doc: PR template: the checklist should only be used for additions (#542)
- fixes https://github.com/awesome-selfhosted/awesome-selfhosted-data/issues/538
2024-01-28 15:46:45 +00:00
nodiscc
ae1d1e648b doc: contributing: add an 'other guidelines' section for soft guidelines (#500)
* doc: contributing: add an 'other guidelines' section for soft guidelines
- these guidelines are only relevant for a small fraction of additions but would significantly increase the number of requirements in the pull request template, so add them in a separate document
- move the guideline about providing a list of differences for forks to this document
- ref. https://github.com/awesome-selfhosted/awesome-selfhosted-data/issues/33#issuecomment-1886405382

---------

Co-authored-by: Rabenherz112 <rabenherz@theravenhub.com>
2024-01-18 19:22:56 +00:00
nodiscc
842be2c6d2 doc/fix: depends_3rdparty must be a valid boolean value (true/false/True/False) (#365)
- ref. https://github.com/awesome-selfhosted/awesome-selfhosted-data/pull/356
2023-11-13 17:51:44 +00:00
kokomo123
3b03524e58 Add demo requirement to template. (#229) 2023-10-03 13:01:48 +00:00
nodiscc
238e5e9b3b group Calendar & Contacts Servers/Web-based clients under a single Calendar & Contacts section (#196)
- since the removal of AgenDav in https://github.com/awesome-selfhosted/awesome-selfhosted-data/pull/145, these no longer pass the check
- ERROR:awesome_lint.py: 2 items tagged Calendar & Contacts - CalDAV or CardDAV Web-based Clients, each tag must have at least 3 items attached
2023-09-22 17:27:43 +00:00
nodiscc
17d3205644 doc/pull request template: approved PRs will be merged after ~1 week (#161) 2023-09-18 14:56:11 +00:00
nodiscc
e20ef1a66c doc/PR/issue template: forks must provide a list of differences with upstream (#95)
- ref. https://github.com/awesome-selfhosted/awesome-selfhosted-data/pull/91
- ref. https://github.com/awesome-selfhosted/awesome-selfhosted/pull/3998
2023-08-26 17:06:03 +00:00
nodiscc
4d462e38cf doc/tools: update instructions for deploy key setup 2023-08-22 15:45:19 +02:00
nodiscc
f40a4842ba tools: switch deployment targets to awesome-selfhosted/awesome-selfhosted(-html) (#63)
- fixes https://github.com/awesome-selfhosted/awesome-selfhosted-data/issues/4
2023-08-22 13:12:34 +00:00
nodiscc
3982f18161 tools/github actions: do not run scheduled jobs on forks of the original repository (#62)
- fixes https://github.com/awesome-selfhosted/awesome-selfhosted-data/issues/60
2023-08-19 11:09:23 +00:00
nodiscc
97f1bad00a tools/github actions: build: always check out the latest commit of the branch that triggered the workflow (#52)
- without this, the commit that would be checked out would be the one that triggered the workflow
- when called from the needs: keyword in daily-update-metadata.yml, the build would run from the version prior to automatic metadata update/commit back to the repository
2023-07-31 20:48:34 +00:00
nodiscc
7e97f588e2 tools: github actions: fail/display red badge when unmaintained projects are detected
- lower error/warning days threshold, but only for the scheduled/daily check (leave thresholds unchanged for pull requests/pre-build checks)
- error if 365 days without updated, warning if 186 days without updates
- update hecat to v1.1.0 https://github.com/nodiscc/hecat/releases/tag/1.1.0
- fixes https://github.com/awesome-selfhosted/awesome-selfhosted-data/issues/50
2023-07-29 17:57:57 +02:00
nodiscc
eb8c117b90 tools/github actions: allow concurrent runs of dead links/unmaintained projects workflows 2023-07-28 14:25:55 +02:00
nodiscc
11520bd624 tools/github actions: split dead links/unmaintained projects check workflow to separate workflows
- generate 2 separate badges and use them in the project README, CONTRIBUTING, output markdown files
- fixes https://github.com/awesome-selfhosted/awesome-selfhosted-data/issues/49
2023-07-28 14:17:50 +02:00
nodiscc
3bb73247d2 tools/github actions: display the target environment URL on the workflow page 2023-07-28 14:08:10 +02:00
nodiscc
07462d18a3 tools/github actions: build/push markdown/html version in parallel 2023-07-28 14:06:06 +02:00
nodiscc
0a6c1bd8fd tools/github actions: update-metadata: only run the build job once the update-metadata job completed successfully 2023-07-27 14:44:22 +02:00
nodiscc
f8fc616e56 tools/github actions: make build workflow reusable by other workflows
- https://docs.github.com/en/actions/using-workflows/events-that-trigger-workflows#workflow_call
- https://github.com/awesome-selfhosted/awesome-selfhosted-data/actions/runs/5680604483
- error parsing called workflow: workflow is not reusable as it is missing a on.workflow_call trigger
2023-07-27 14:42:02 +02:00
nodiscc
7412b5ad24 tools/github actions: build and push html/markdown exports after automatic metadata updates
- ref. https://github.com/awesome-selfhosted/awesome-selfhosted-data/issues/45
2023-07-27 14:33:54 +02:00
nodiscc
197d9cd7a7 doc: move contribution guidelines to CONTRIBUTING.md (#44)
- fixes https://github.com/awesome-selfhosted/awesome-selfhosted-data/issues/40
- doc: ISSUE_TEMPLATE/other.md: cleanup
- doc: .github/PULL_REQUEST_TEMPLATE.md: fix link to addition template
- doc: LICENSE: fix license file header/auomatic license detection by Github
- doc: license: add link to summary of license terms
- doc: group authors and licenses sections
2023-07-26 19:50:16 +00:00
nodiscc
d157f626ce tools: makefile/github actions: don't call make install target multiple times
- make install must only run manually when the build environment has not been set up yet
2023-07-24 20:36:24 +02:00
nodiscc
6ea9e4507f finalize automation/CI workflows:
- build markdown/HTML versions, use separate makefile targets/hecat configuration files for each export format/push task
- add non-free.md generation step to markdown export hecat configuration file
- add makefile targets to push exports to https://github.com/awesome-selfhosted/awesome-selfhosted and https://github.com/nodiscc/awesome-selfhosted-html-preview
- install: install sphinx <7 directly using pip since it can't be installed from setup.py https://github.com/sphinx-doc/sphinx/issues/11130
- pin sphinx to version <7, sphinx-design is not compatible with sphinx 7 https://github.com/executablebooks/sphinx-design/issues/130
- add sphinx configuration file
- tools/makefile: monkeypatch furo theme to display build tools and license link in footer (furo/sphinx does not provide a way to customize this https://github.com/pradyunsg/furo/discussions/612)
- fix dependencies between makefile targets
- setup/document SSH deploy keys usage
- each repository requires a different deploy key, trying to add a deploy key to repo B, which has already been added to repo A results in error 'this key already exists'
- set git remote URL to use ssh URIs before push (required to use SSH deploy keys)
- when referencing an environment secret, environment: key must be defined explicitly for the step (https://docs.github.com/en/actions/deployment/targeting-different-environments/using-environments-for-deployment#referencing-an-environment)
- use a single SSH key file/no ssh-agent, else git push will try to use the first registered key and fail with permission denied when trying to push to the HTML repository
- use variables to identify target repos
- use temporary repositories as push destination
2023-07-24 16:10:43 +02:00
nodiscc
423b418371 tools/github actions: fix concurrency between workflows
- only jobs that are part of the same workflow should not run concurrently
2023-07-22 19:13:03 +02:00
nodiscc
696063534a tools: github actions: job IDs may only contain alphanumeric characters, '_', and '-'. 2023-07-22 19:06:02 +02:00
nodiscc
316e59bcb7 tools: github actions: run daily dead link checks and unmaintained projects checks in parallel 2023-07-22 19:04:29 +02:00
nodiscc
05ad5ea709 tools/github actions: set job names 2023-07-22 11:34:55 +02:00
nodiscc
986e2dde55 tools/github actions: set workflow names
- https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#name
2023-07-22 11:33:03 +02:00
nodiscc
083b9f0605 tools/github actions: separate workflows for pull requests and build from each commit on master 2023-07-22 11:26:01 +02:00
nodiscc
af5ff2b3e5 tools/github actions: move url checks to a separate workflow
- schedule at same time as the daily metadata update workflow
2023-07-22 11:21:05 +02:00
nodiscc
39d413986c tools/github actions: rename workflows/update-metadata.yml -> daily-update-metadata.yml 2023-07-22 11:15:22 +02:00
nodiscc
4d56c60da4 doc: add pull request template 2023-07-17 14:15:12 +02:00
nodiscc
a82f886790 issue template/addition: import guidelines from https://github.com/awesome-selfhosted/awesome-selfhosted/blob/master/.github/PULL_REQUEST_TEMPLATE.md 2023-07-17 14:14:06 +02:00
nodiscc
951bcdac00 doc: addition.md: clarify software entry template 2023-07-17 14:12:24 +02:00
nodiscc
2322f5ce55 tools/makefile: add make authors target (update AUTHORS file)
- update documentation
2023-07-16 17:49:15 +02:00
nodiscc
dbb19c90aa doc: ISSUE_TEMPLATE/addition.md: improve example 2023-07-16 16:29:23 +02:00
nodiscc
9345d7c883 github actions: update-metadata: allow manually triggering workflow run 2023-06-16 14:03:45 +02:00
nodiscc
c7e09df481 github actions: repository must be checked out before running make url_check
- fixes https://github.com/awesome-selfhosted/awesome-selfhosted-data/issues/27
2023-06-16 14:00:50 +02:00
nodiscc
ce136cf477 github actions: update-metadata: run metadata update and URL check jobs in parallel
- ref. https://github.com/awesome-selfhosted/awesome-selfhosted-data/issues/27
2023-06-15 23:47:12 +02:00
nodiscc
926ac11a15 tools: issue templates: add an issue template for 'other' issues 2023-01-24 18:05:23 +01:00
nodiscc
2745323ec8 tools: github actions: prevent multiple concurrent workflow runs on the same branch/ref
- cancel other pending/in-progress workflows if a new commit is pushed to the ref
- ref. https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#concurrency
2023-01-24 18:04:47 +01:00
nodiscc
0f3b106e12 tools: github actions: always run URL checks last in all workflows
- make errors fatal/exit with code 1 if any checks are unsuccessful
2023-01-24 17:51:03 +01:00
nodiscc
6ad29ab5b8 tools: github actions: run URL checker *after* pushing changes in the scheduled update-metadata workflow
- we want the updates pushed regardless of possible URL check errors
2023-01-24 17:18:29 +01:00
nodiscc
b3f0ff5070 tools: github actions: don't trigger duplicate workflows on pull requests 2023-01-24 17:17:25 +01:00
nodiscc
28005c507e tools: github actions: add automatic URL checks using hecat/url_check module 2023-01-24 16:55:46 +01:00
nodiscc
8db83e4fd0 tools: github actions: run make awesome_lint/make export explicitly as part of the scheduled update-metadata workflow (#21)
- workaround/closes https://github.com/awesome-selfhosted/awesome-selfhosted-data/issues/15
2023-01-23 01:10:35 +00:00