Apply bestie

.JuliaFormatter.toml

@@ -0,0 +1,3 @@
+indent = 4
+margin = 92
+normalize_line_endings = "unix"

.all-contributorsrc

@@ -0,0 +1,5 @@
+{
+  "projectName": "GalerkinToolkit",
+  "projectOwner": "GalerkinToolkit",
+  "files": ["README.md", "docs/src/index.md"]
+}

.copier-answers.yml

@@ -0,0 +1,13 @@
+# Changes here will be overwritten by Copier
+AnswerStrategy: recommended
+Authors: Francesc Verdugo <[email protected]> and contributors
+CodeOfConductContact: [email protected]
+JuliaIndentation: 4
+JuliaMinVersion: '1.10'
+License: MIT
+LicenseCopyrightHolders: Francesc Verdugo
+PackageName: GalerkinToolkit
+PackageOwner: GalerkinToolkit
+PackageUUID: 5e3ba9c4-dd81-444d-b69a-0e7bd7bf60a4
+_commit: v0.13.0
+_src_path: https://github.com/JuliaBesties/BestieTemplate.jl

.editorconfig

@@ -0,0 +1,18 @@
+# https://editorconfig.org
+root = true
+
+[*]
+end_of_line = lf
+insert_final_newline = true
+charset = utf-8
+indent_style = space
+trim_trailing_whitespace = true
+
+[*.jl]
+indent_size = 4
+
+[*.md]
+indent_size = 2
+
+[*.{yml,toml,json}]
+indent_size = 2

.github/ISSUE_TEMPLATE/10-bug-report.yml

@@ -0,0 +1,60 @@
+name: Bug Report
+description: File a bug report related to running the package
+title: "[Bug] "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to fill out this bug report!
+
+        Please, before submitting, make sure that:
+
+        - There is not an [existing issue](https://github.com/GalerkinToolkit/GalerkinToolkit.jl/issues) with the same question
+        - You have read the [contributing guide](https://GalerkinToolkit.github.io/GalerkinToolkit.jl/dev/90-contributing/)
+        - You are following the [code of conduct](https://github.com/GalerkinToolkit/GalerkinToolkit.jl/blob/main/CODE_OF_CONDUCT.md)
+        The form below should help you in filling out this issue.
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: Describe the bug
+    validations:
+      required: true
+  - type: input
+    id: pkg-version
+    attributes:
+      label: Package Version
+      description: What version of the package are you running?
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: Julia Version
+      description: What version of Julia are you running?
+    validations:
+      required: true
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Reproduction steps
+      description: What steps led to the bug happening? Please provide a minimal reproducible example.
+    validations:
+      required: true
+  - type: textarea
+    id: logs
+    attributes:
+      label: Relevant log output
+      description: Please copy and paste any relevant log output. This will be automatically formatted into code, so no need for backticks.
+      render: shell
+  - type: dropdown
+    id: os
+    attributes:
+      label: "Operating System"
+      description: What is the impacted environment?
+      multiple: true
+      options:
+        - Windows
+        - Linux
+        - Mac

.github/ISSUE_TEMPLATE/20-feature-request.yml

@@ -0,0 +1,41 @@
+name: "Feature Request"
+description: Suggest a new feature for the package
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to fill out this feature request!
+
+        Please, before submitting, make sure that:
+
+        - There is not an [existing issue](https://github.com/GalerkinToolkit/GalerkinToolkit.jl/issues) with the same question
+        - You have read the [contributing guide](https://GalerkinToolkit.github.io/GalerkinToolkit.jl/dev/90-contributing/)
+        - You are following the [code of conduct](https://github.com/GalerkinToolkit/GalerkinToolkit.jl/blob/main/CODE_OF_CONDUCT.md)
+        The form below should help you in filling out this issue.
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: Describe the requested feature
+    validations:
+      required: true
+  - type: textarea
+    id: validation
+    attributes:
+      label: Validation and testing
+      description: How could we verify that the new feature works? What kind of tests can be done?
+  - type: textarea
+    id: motivation
+    attributes:
+      label: Motivation
+      description: Explain why this feature is relevant
+  - type: textarea
+    id: target
+    attributes:
+      label: Target audience
+      description: Tell more about the users of this feature, or where it could be useful
+  - type: textarea
+    id: can-help
+    attributes:
+      label: Can you help?
+      description: Can you help developing this feature?

.github/ISSUE_TEMPLATE/30-usage.yml

@@ -0,0 +1,23 @@
+name: "Usage question"
+description: Questions related to the usage
+labels: ["documentation"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to fill out this question!
+
+        Please, before submitting, make sure that:
+
+        - You have checked the [documentation](https://GalerkinToolkit.github.io/GalerkinToolkit.jl) and haven't found enough information
+        - There is not an [existing issue](https://github.com/GalerkinToolkit/GalerkinToolkit.jl/issues) with the same question
+        - You have read the [contributing guide](https://GalerkinToolkit.github.io/GalerkinToolkit.jl/dev/90-contributing/)
+        - You are following the [code of conduct](https://github.com/GalerkinToolkit/GalerkinToolkit.jl/blob/main/CODE_OF_CONDUCT.md)
+        The form below should help you in filling out this issue.
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: Write your question
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/99-general.yml

@@ -0,0 +1,21 @@
+name: "General issue"
+description: In case none of the others templates apply
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to fill out this issue!
+
+        Please, before submitting, make sure that:
+
+        - There is not an [existing issue](https://github.com/GalerkinToolkit/GalerkinToolkit.jl/issues) with the same question
+        - You have read the [contributing guide](https://GalerkinToolkit.github.io/GalerkinToolkit.jl/dev/90-contributing/)
+        - You are following the [code of conduct](https://github.com/GalerkinToolkit/GalerkinToolkit.jl/blob/main/CODE_OF_CONDUCT.md)
+        The form below should help you in filling out this issue.
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: Describe the issue
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Discussions
+    url: https://github.com/GalerkinToolkit/GalerkinToolkit.jl/discussions
+    about: Create and follow discussions here

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,27 @@
+<!--
+Thanks for making a pull request to GalerkinToolkit.jl.
+We have added this PR template to help you help us.
+Make sure to read the contributing guidelines and abide by the code of conduct.
+See the comments below, fill the required fields, and check the items.
+-->
+
+## Related issues
+
+<!-- We normally work with (i) create issue; (ii) discussion if necessary; (iii) create PR. So, at least one of the following should be true:-->
+
+<!-- Option 1, this closes an existing issue. Fill the number below-->
+Closes #
+
+<!-- Option 2, this is a small fix that arguably won't need an issue. Uncomment below -->
+<!--
+There is no related issue.
+-->
+
+## Checklist
+
+<!-- mark true if NA -->
+<!-- leave PR as draft until all is checked -->
+- [ ] I am following the [contributing guidelines](https://github.com/GalerkinToolkit/GalerkinToolkit.jl/blob/main/docs/src/90-contributing.md)
+- [ ] Tests are passing
+- [ ] Lint workflow is passing
+- [ ] Docs were updated and workflow is passing

.github/dependabot.yml

@@ -0,0 +1,7 @@
+# https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/" # Location of package manifests
+    schedule:
+      interval: "weekly"

.github/workflows/Docs.yml

@@ -0,0 +1,57 @@
+name: Docs
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - "docs/**"
+      - "src/**"
+      - "*.toml"
+    tags: ["*"]
+  pull_request:
+    branches:
+      - main
+    paths:
+      - "docs/**"
+      - "src/**"
+      - "*.toml"
+    types: [opened, synchronize, reopened]
+
+concurrency:
+  # Skip intermediate builds: always.
+  # Cancel intermediate builds: only if it is a pull request build.
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: ${{ startsWith(github.ref, 'refs/pull/') }}
+
+jobs:
+  docs:
+    name: Documentation
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: julia-actions/setup-julia@v2
+        with:
+          version: "1"
+      - name: Use Julia cache
+        uses: julia-actions/cache@v2
+      - name: Instantiate environment with development version of the package
+        run: |
+          julia --project=docs -e '
+            using Pkg
+            Pkg.develop(PackageSpec(path=pwd()))
+            Pkg.instantiate()'
+      - name: Run doctest
+        run: |
+          julia --project=docs -e '
+            using Documenter: DocMeta, doctest
+            using GalerkinToolkit
+            DocMeta.setdocmeta!(GalerkinToolkit, :DocTestSetup, :(using GalerkinToolkit); recursive=true)
+            doctest(GalerkinToolkit)'
+      - name: Generate and deploy documentation
+        run: julia --project=docs docs/make.jl
+        env:
+          JULIA_PKG_SERVER: ""
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          DOCUMENTER_KEY: ${{ secrets.DOCUMENTER_KEY }}
+          GKSwstype: "100" # https://discourse.julialang.org/t/generation-of-documentation-fails-qt-qpa-xcb-could-not-connect-to-display/60988